REMARKS 



In the Official Action mailed on 18 April 2007, the Examiner reviewed 
claims 1-3, 5-16, 18-29 and 31-39. Claims 1-3, 5-16, 18-29, and 31-39 were 
rejected under 35 U.S.C. § 103(a) as being anticipated by Wu et al. (US Pub. No. 
2005/0033726 hereinafter "Wu"), and further in view of Gary Willman Policastro 
(US Pub. No. 2003/0018605 hereinafter "Policastro"). 

Objection to Affidavit C.F.R. 1.131 

In the office action of 18 April 2007, Examiner avers that the evidence 
submitted in support of the Affidavit - 37 C.F.R. 1.131 was insufficient to 
establish a reduction to practice of the invention prior to the effective data of the 
cited prior art references. In the phone conversation with the Examiner of 4 May 
2007, Examiner suggested that this rejection could be overcome by (1) 
establishing an actual reduction-to-practice data prior to the effective date of the 
reference, and (2) mapping the product to the elements of the independent claims. 
In response, applicant provides the following evidentiary support to establish both 
the reduction-to-practice date and the mapping between the produce the claim 
limitations. 

Actual Reduction to Practice 

As declared in the 37 C.F.R. § 1.131 declaration executed on 6 February 
2007, embodiments of the present invention were implemented in Oracle 
Warehouse Builder 9.0.4 (hereinafter the "product"), which was commercially 
available in March 2003. The effective date of the main reference, Wu, is 19 May 
2003. Therefore, the actual reduction-to-practice of embodiments of the present 
invention predates Wu. The following third-party news releases show the date 
when this product became commercially available (the printouts are attached to 
this paper). 



9 

DJH W:\Oracle Corporation\OR03\OR03-0400l\Amendment F OR03-04001 .doc 



http://www.infoworld.eom/article/03/03/l 2/HNwarehousebuilder_l .html 

http://www.computemorldxom/databasetopics/data/software/story/0 5 1 080 
l,79326 ? 00.html 

http://www.internetnews.eom/ent-news/article.php/2 1 08471 

Mapping Between Product the Claim Elements 

Applicant avers that the independent claims are disclosed in the Oracle 
Warehouse Builder 9.0.4 manual, which can be found at: 

http://download-west.oracle.eom/docs/html/B 1 0657 J)l/toc.htm 

Specifically, claim 1 includes the following operations: 

1) creating metadata, under the control of a user, for use in the data 
warehouse system; 

2) moving the metadata, under the control of a super user, into and out of 
a collection, thereby securing the metadata; 

3) assigning, under the control of the super user, a data steward for the 
collection; and 

4) manipulating, under the control of the data steward, the metadata in the 
collection, wherein manipulating the metadata involves securing the 
metadata and performing administration operations on the collection, 
wherein only the data steward can manipulate the metadata in the 
collection, and wherein manipulating the metadata includes editing and 
deleting the metadata. 

Operation 1) is disclosed in chapter 14, on page 19, "Add new metadata 
only (Create Mode)...," and in chapter 18 on page 1, "You create and manage 
UDPs using the Oracle MetaBase (OMB) Scripting Language." 
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Operation 2) is disclosed in chapter 14, on page 1, "The Metadata Loader 
(MDL) enables you to populate a new repository as well as transfer. . and on 
page 1, "You can import and export metadata.../ 5 , in chapter 17, on page 10, 
"Click register an OWB Repository on the Warehouse Builder Administration 
home page. . . " and in chapter 18, on page 5, "The primary method for 
propagating changes. . ." 

Operation 3) is disclosed in chapter 17, on page 1 1, Table 17-2 Repository 
Management, on page 19, ". . . one of these Warehouse builder pre-defined roles. . . 
The Administrator can assign these roles...," on page 21, "The preferences you 
can save include. . . Access rights associated with roles, repositories. . .", and in 
chapter 1 8, on page 6, "Multiple identifiable Warehouse Builder users can access 
the same central repository schema when they are registered by the repository 
owner.," and on page 7, "Register repository users." 

Operation 4) is disclosed in chapter 18, on page 11, "To control users who 
can invoke. . .," on page 11, "You can also use it to control which use can invoke 
this operation." on page 11, "Definition of constants for all basic operations," on 
page 11, "You can also use it to control which use can invoke this service 
operation.," on page 12, "You can also use it to implement your access control. . ." 

Chapters 14, 17, and 19 of the produce manual are attached with this 

paper. 

Applicant avers the above cited references disclose the teachings of 
independent claim 1, and similar the teachings of independent claims 14 and 27. 
Hence, Applicant avers that the present invention pre-dates the prior art and thus, 
the claims of the instant application are in condition for allowance. 
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CONCLUSION 



It is submitted that the instant application is presently in condition for 
allowance. Such action is respectfully requested. 



Shun Yao 

PARK, VAUGHAN & FLEMING LLP 

2820 Fifth Street 

Davis, CA 95618-7759 

Tel: (530) 759-1667 

FAX: (530) 759-1665 

Email: shun@parklegal.com 



Respectfully submitted, 




Shun Yao 
Registration No. 59,242 



Date: 15 May 2007 
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Oracle upgrades data warehouse tool 

Links to database emphasized 



By Paul Ktill 
March 12, 2003 
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Oracle on Wednesday is shipping Oracle9i Warehouse Builder Version 9.0.4, an enterprise integration tool for managing data in business 
intelligence applications. 
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The software helps reduce the cost and 
time associated with data integration by 
providing an ETL (extraction, 
transformation, and loading) tool that 
enables database administrators to 
design and build business intelligence 
applications, according to Oracle. Visual 
models and wizard-driven interfaces are 
featured for graphically designing 
end-to-end ETL processes including 
warehouses and intermediate storage 
areas. 
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The product is optimized for all versions 
of the Oracle database and takes 
advantage of ETL functions in the latest 
release of the database, Oracle9i 
Database Release 2. Warehouse 
Builder 9.0.4 also utilizes the OnUne 
Analytical Processing (OLAP) engine in the new database. 

Other new features include support for data extraction from SAP R/3 systems, a RunTime Audit Browser to ensure data quality while 
exposing audit and history information to verify job results, and a Process Flow Editor for visually building ETL transformations. 

Oracie9i Warehouse Builder Version 9.0.4 is sold as part of the Oracle9i Developer Suite, which costs $5,000 per developer. It is supported 
on platforms such as Linux, Sun Microsystems Solaris, and Microsoft Windows. 
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Paul Roberts, IDG News Service Today's Top Stories * or Other Databases Stories • 

March 13, 2003 (IDG News Service) - A new version of Oracle Corp.'s Data Warehouse Builder will make it easier 
for database developers and administrators to tie together information from different data stores within an enterprise, 
the company announced yesterday. 

Version 9.0.4 of the Orac!e9i Data Warehouse Builder (OWB) includes a number of enhancements from previous 
versions, according to Oracle. 
Those enhancements include: 

A new SAP Integrator that makes it easier to extract information from SAP R/3 systems by SAP AG. 
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Better workflow features and a more user-friendly 
interface that simplifies the process for creating 
extract, transform and load (ETL) processes. 

Support for industry standards such as XML 
Metadata Interchange and Process Description 
Language to simplify the process of integrating 
OWB with third-party products. 



Oracle9i Warehouse Builder is used to pull data 
from disparate sources such as financial and 
accounting databases into an Oracle9i database. 
Once data is in a predictable format within Oracle, 
it can be accessed by more sophisticated analytic 
tools such as customer relationship management 
and enterprise resource planning applications, 
according to Mark Shainman, a senior analyst at 
Meta Group Inc. 

OWB competes with similar "native" ETL tools from 
Microsoft Corp., which offers its Data 
Transformation Services (DTS), and IBM, which 
sells Warehouse Manager, according to Shainman. 

By making it easier for database developers to pull 
data into a specific database environment such as 
Oracle or SQL Server, native ETL tools are 
competing with more expensive, but "database 
agnostic" tools such as those by Cognos Inc. and 
Informatica Corp. 

Database vendors are investing heavily in ETL 
tools, hoping to drive adoption of their databases 
as platforms for centralized data warehouses, 
according to Shainman. "People want to know 
what's going on in their businesses. The database 
licensing sales and momentum are behind decision 
support and data warehouses. That's where the 
spending is," he said. 

Gregory Richard, chief technology officer of 
Canadian company DecisionsToday Inc. in Hull, 
Quebec, said that his company uses OWB in 
addition to Microsoft's DTS and Cognos' Decision 
Stream to build tools that accelerate the process of 
building data warehouses. Decisions Today's 
software does analysis of an organization's 
business databases and systems, automatically 

generating a data warehouse model and ETL routines to supply it. The software is licensed directly to database 
vendors and sold to large enterprises, Richard said. 

Due to limitations in OWB's scripting environment, Decisions Today was prevented from integrating with prior product 
editions. Version 9.0.4 of OWB fixed that problem, and Decision Today is now using OWB to build and automate 
ETL processes for Oracle, Richard said. 

The product's user interface is also much improved in the latest version, Richard said. "It used to be quite 
cumbersome to use. You had to pop in and out of dialog boxes a lot " 

The product's new interface brings it more in line with competing products, providing a diagram to represent an 
overall build and "point and click" support for editing object properties. 

Version 9.0.4 runs on a variety of platforms, including Linux, Sun Solaris and Windows. The product is being offered 

for $5,000 per Named User Plus as part of the Oracle9i Developer Suite, according to Oracle. 

Despite its focus on deploying to the Oracle environment, OWB offers a powerful and relatively inexpensive 

alternative to other solutions, Richard said. "When you look at price per feature, OWB blows the others away," he 

said. 

Reprinted with permission from 

KSMBM For more news from IDG visit IDG.net 

ialHSHI Story copyright 2006 International Oata Group. All rights reserved. 
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March 12, 2003 

Oracle Tweaks Business Intelligence 

Software 

By Clint Boulton 

Oracle ( Quote ) Wednesday revamped a business 
integration tool that facilitates and manages data 
in business intelligence applications. 

Business intelligence is the gathering of as much 
pertinent data as possible to make better 
business choices. Applications that fall under its 
umbrella include those for decision support 
systems, query and reporting, online analytical 
processing (OLAP), statistical analysis, 
forecasting, and data mining. Redwood Shores, 
Calif.-based Oracle's competitors in this space 
include IBM, but other players such as Cognos, 
Applix and Hyperion provide some aspect of 
business intelligence software. 

Oracle's new product, Oracle9i Warehouse Builder 
Version 9.0.4, is an extraction, transformation 
and loading (ETL) tool that lets database 
administrators and developers design and build 
business intelligence applications more efficiently. 

Speaking of the integration aspects, Oracle9i 
Warehouse Builder Version 9.0.4 uses the Oracle 
Database as its runtime engine, relies on the ETL 
capabilities and OnLine Analytical Processing 
(OLAP) engine built into Oracle9i Database 
Release 2 to create multi-dimensional objects. 

As with many enterprise software players, Oracle 
pledges allegiance to open standards, and in this 
instance, crafted a product that will work well 
with competitor's software. 

For example, Warehouse Builder Version 9.0.4 
supports Microsoft's SQL for data integration 
routines, Object Management Group's Common 
Warehouse Meta-Model (OMG CWM) and 
extensible Markup Language Metadata 
Interchange (XMI) for metadata exchange, as 
well as the new Processing Description Language 
(XPDL) for process definition. 

In addition to support for mainframes and other 
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databases such as IBM and Sybase, the new tool 
includes a SAP Integrator that generates code to 
extract data from SAP R/3 systems and populate 
data warehouses. 

The software also features a Runtime Audit 
Browser to verify the results of all running jobs 
and reveal any errors that may have occurred 
while loading data and a Process Flow Editor that 
allows users to create ETL transformations and 
automatically generate code to integrate these 
and other business processes. 

Oracle9i Warehouse Builder Version 9.0.4 is 
available now for free download and evaluation 
from Oracle Technology Network. It also can be 
purchased for $5,000 per Named User Plus from 
the Oracle Store as part of OracIe9i Developer 
Suite. 
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O Applying RFID Technology in High Volume Manufacturing 
To explore the impact of radio frequency identification (RFID) 
technology in manufacturing, Intel's Technology and Manufacturing 
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from the end of the manufacturing line through Intel's warehouse, Into a 
major customer's warehouse, and onto the customer's factory floor. 
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To drive business decisions In the data center, Intel IT created a 
performance-driven methodology to compare the operating costs of 
visualization platforms. By measuring workload performance, platform 
performance, and power consumption they were able to approximate 
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accessed by over 1 1 ,000 users worldwide. Click here. 
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data center? Click here. 
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Importing and Exporting with the Metadata 
Loader (MDL) 

A The Metadata Loader (MDL) enables you to populate a new repository as well as transfer, update, or 
J restore a backup of existing repository metadata. You can also take snapshots of your metadata and use 
them for backup, compare, and restore purposes. 

This section contains the following topics: 

• Overview of Import and Export Using Metadata Loader 

• Importing and Exporting Metadata Using the Metadata Loader 

• Exporting Metadata 

• Importing Metadata 

• Using the Metadata Loader Command Line Utility 

• Splitter for Exporting and Importing Warehouse Builder Mappings 



Overview of Import and Export Using Metadata Loader 

Warehouse Builder provides several features that enable you to copy and move metadata for the 
purposes of backup, history management and version management. 

You can import and export metadata for any type of object on the navigation tree using the Metadata 
\ Loader (MDL) utility. Access MDL through the Warehouse Builder client or through the OMB Plus 
J scripting interface. Use the import and export functionality to backup metadata or to migrate metadata 

when upgrading Warehouse Builder. 

You can also then move exported files into a third-party version control tool such as Oracle Repository, 
ClearCase, or SourceSafe. If you enter version numbers in your project properties, it is easier to track 
your export and import versions in this setting. 

You can also perform metadata change management by taking snapshots of your metadata using the 
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OMB Plus scripting interface. Snapshots enable you to capture definitions of metadata objects using 
Warehouse Builder scripts. Use snapshots for the purpose of metadata backup and version management. 
For more information about metadata change management, see Chapter 15, "Metadata Change 
Management" . 

Importing and Exporting Metadata Using the Metadata 
Loader 

The MDL enables you to copy or move metadata objects between repositories, even if those repositories 
reside on platforms with different operating systems. 

The MDL consists of two utilities: metadata export and metadata import. The export utility extracts 
metadata objects from a repository and writes the information into a text file. The import utility reads the 
metadata information from an exported text file and inserts the metadata objects into a repository. MDL 
uses its own format, and the MDL import utility only reads files of MDL format (files created by MDL 
Export or MDL File Upgrade). 

You can operate the MDL from the Warehouse Builder console or by using a command line interface. 
For instructions on using MDL through the command line interface, refer to "Using the Metadata Loader 
Command Line Utility" . If you use the console menu, a graphical interface guides you through the export 
or import processes. 

Use the metadata loader to perform any of the following tasks: 

• Backup metadata: The MDL is an important part of your disaster recovery strategy. You can 
export a file with your existing repository metadata as a backup and use that exported file to 
restore a repository if necessary. 

• Seed a new repository: You can export data from an existing repository and use it as the basis for 
a new repository. 

• Migrate a repository: You can export metadata to a file and then re-import it. This is commonly 
done when upgrading to a newer version of Warehouse Builder. For details on upgrading from a 
previous version of Warehouse Builder, see the Oracle9i Warehouse Builder Installation and 
Configuration Guide. 

• Copy metadata: A multiple user development environment can result in multiple copies of the 
same metadata. The MDL makes it easy to load single set metadata into more than one repository. 

This section contains the following topics: 

• Required Access Privileges for MDL 

• About Metadata Loader Results 

• About the Metadata Loader Log File 

Required Access Privileges for MDL 
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The Warehouse Builder repository allows multiple clients to access the same repository schema 
concurrently. Warehouse Builder uses locks to allow only one client to access to change repository 
objects. While an object is locked, other clients can only view it as it existed after the last transaction 
instigated by any user is committed. 

Tip: 

To ensure that you are exporting the most up-to-date metadata, you need to be the 
sole client accessing the repository. 

If you click OK when prompted, the MDL commits changes made to the repository after a successful 
metadata import (any import with no error messages, including imports with only information or 
warning messages). The MDL also executes a rollback after an unsuccessful import. This means that 
Warehouse Builder attempts to acquire one lock for each primary object (an object in the first level on 
the navigation tree) in the repository that matches an object in the MDL file. These objects include, but 
are not limited to, projects, modules, and tables-individual columns are not locked. Therefore, you must 
be able to hold the locks for these objects while you import metadata. If other users hold locks for 
objects to which you are importing, the MDL will fail. 

Tip: 

To ensure a successful metadata import, you need to be the sole client accessing the 
repository. 

If the MDL import affects too many objects in the repository, the MDL automatically switches to single 
user mode. This means that no other users can log on to the repository until after the MDL import 
completes. Single-user mode allows the MDL to avoid the performance degradation that results from 
using a large number of locks. In single-user mode, the MDL is less likely to deplete the repository 
enqueue resources. If other users are logged into this repository when MDL attempts to switch to 
single-user mode, MDL cannot switch to single-user mode and subsequently fails. 

You also need to have MDLJMPORT security privileges in order to import metadata. For more 
information on security, see "Managing Security with PL/SQL" . 

About Metadata Loader Results 

Each time you use the export or import utilities, the MDL reports the results of an action and writes 
diagnostic and statistical information to a log file. 

The MDL reports the results after any import or export task with a dialog. If you want detailed 
information, you can view a detailed log by clicking View Log File from the Metadata Export Results 
dialog as shown in Figure 14-1 . 

Figure 14-1 Metadata Export Results 
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J§8 Metadata Export Results 



Metadata exported to file "e:\MDL\GCCWarehouse-exp-SATJULONE" 
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Object Type 



ORACLEINSTALLEDMODULE 



SAPINSTALLEDMODULE 



FILEINSTALLEDMODULE 



DATAWAREHOUSE 
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IT 







^ View Log File ^ 
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Text description of the illustration meuexpre.gif 



The results dialog lists the metadata objects found in either the file or the repository, and the number of 
each object that was exported or imported. You can use the results dialog to ensure that all of the objects 
were exported or imported. The MDL identifies the objects that were exported or imported and 
compares it with the eligible objects list. A zero in the Number Exported or Number Imported column 
for any object indicates that the MDL found no object of that type in the repository. However, if a zero 
appears for any object that exists in the repository or imported MDL file, then MDL encountered a 
problem when importing or exporting that object. 



About the Metadata Loader Log File 



Whenever you export or import repository metadata, the MDL writes diagnostic and statistical 
information to a log file. By default, the log file is located in the directory and path specified in the 
Message Log tab located in the Preferences dialog. You can specify an alternative location for the log 
file when invoking MDL. 



Example 14-1 displays the contents of a typical import log file. 



Example 14-1 Log File Showing Import Results 



Import started at 04/25/2001 4:59:46 PM 
****************************^ 

* Import for OWB Release: 3.0.0.0.0 Version: 3.0.0.3.0 

* User: user30_3i Connect String: epaglina-pc : 1521 : ora8i 

* Data File: d:\owb3000\sco_dim__time_phy_m_tgt.mdl 

* Log File: d:\owb3000\imp_dim_time_phy_m_tgt.log 

* Trace: B 

* Trace File: d:\owb3000\imp_dim_time_phy_m_tgt.trc 

* Physical Names: Y Mode: CREATE 

* Ignore Universal Identifier: Y Commit At End: Y 
******************************^ 

Informational at line 15: MDL-1207 PROJECT with physical name <PRJ_Dimension> not impor 
because it already exists. 

Informational at line 21: MDL-1207 DATAWARE HOU S E with physical name <WH> not imported 
because it already exists. 

Informational: MDL-1134 COMMIT issued at end of import data file. 
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Counts for OWB Import Utility 



Total Projects Processed by Import = 1 



Project = PRJ_Dimension 



Entity in Project 



Added 



Replaced 



Skipped 



DATAWARE HOUSE : 

DIMENSION: 

LEVEL: 

HIERARCHY: 

LEVELRELATIONSHIP: 

COLUMN : 

UNIQUEKEY: 

PRIMARYKEY: 

CONFIGPARAM: 

CHILDCONFIG: 



0 
1 
3 
2 
4 
18 
8 
2 
60 
14 



0 
0 
0 
0 
0 
0 
0 
0 
0 
0 



1 

0 
0 
0 
0 
0 
0 
0 
60 
0 



Import ended at 04/25/2001 4:59:52 PM 

The log file enables you to monitor and troubleshoot export and import activities in detail. The log file 
contains the following types of status messages: 

• Informational: Provides information about the import or export, such as missing metadata 
objects, whether or not objects were imported, and any reasons why they were not imported or 



• Warning: Cautions you about the import or export of an object but does not indicate a failed or 
aborted load. A warning notifies you of the possibility of unexpected load results for the load. 

• Error: Indicates that the MDL export or import was aborted and did not complete successfully. 
The error message offers a brief reason for the failure. 

This log also displays the total number of objects that have been added, replaced, and skipped. A zero in 
any column for any object indicates that the MDL found no object of that type in the repository or in the 
imported MDL file. 

Detailed Error Logs 

If you are running an MDL Import and encounter an error, an error message displays. 

Click Detail to display a detailed error log that lists the repository object and the object line in which the 
error occurred. Detailed messages are useful whenever you import metadata into repositories with 
existing metadata because they alert you to problems such as improperly defined metadata objects and 
object duplication. 

Figure 14-2 is an example of a detailed error message. 
Figure 14-2 Detailed Error Message 



exported. 
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Error occurred importing from file "E:\OtherStumUnZip\New 

Foldertdim import2.mdr. 
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- import for OWB Release: 3.0.0.22.0 Version: 3.0.0.2.0 

* User: owb3i_sallson2 Connect String: 
(DESCRIPTION=(ADDRESS=(HOST=dwqalab37.pc)(PROTOCOL=tcp) 
(PORT=1 521»<CONNECT_DATte(SID=owbqa81 7))) 

* Data File: E:\OtherStuffiUnZip\New Foldertdim jmport2.mdl 

* Log File: D:\QWB3i\owb\birrtadmin\Log.log 
Physical Names: Y Mode: INCREMENTALUPDATE Character Set 



WE8MSWIN1252 

. . . 



Ill tm 



MmmWM 
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II i 



Import started at 05/22/2001 5:23:04 PM 



u^mmmM. 



■llllli 



* Ignore Universal Identifier: Y Commit At End; Y 



AXAA 

: ; --:-xis* 



Error at line 68: MDL-1 402 Error importing dimension with physical name 
<0D83D0A94ECE1 1 D5A05F0QB0D025C08E* in module <WH> 
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Detailed Error Message: 

Error at line 71: MDL-1 434 Cannot import LEVEL with logical name 

: ' i ■ ■ ■ ■ ■ 

<Total> because another LEVEL with the same logical name already 
exists in DIMENSION <CUST>. ' ' ''m : ^'"' ' r f ■ : 



mmi 



A A A A A A A A A A A A A A J 




Text description of the illustration det err ,gif 

In this example, the repository object is the CUST dimension and the imported object is the TOTAL 
level. The dialog explains that the TOTAL level cannot be imported into the CUST dimension because a 
level named TOTAL already exists. 



Exporting Metadata 

The Metadata Loader can export all repository objects. The MDL also exports information belonging to 
metadata objects such as table columns and their constraints, data loading configuration parameters, and 
named attribute sets. You can use the MDL to export an entire project or a subset of objects within a 
project. 

When you export repository metadata, the Metadata Loader writes the extracted metadata to a delimited 
text file. The MDL stores this file outside the repository by assigning a default path and file name to the 
exported MDL file. 
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This section contains the following topics: 

• Before Exporting Metadata 

• About the Metadata Export Utility 

• Exporting Metadata using Warehouse Builder Client 

• Metadata Export File Format 

• Archiving a Project 

Before Exporting Metadata 

Before you attempt to export metadata, ensure you have the following: . 

• Required access privileges. To ensure that you are exporting the most up-to-date metadata, verify 
that you are the sole client accessing the repository in read/write mode. For more details, see 
"Required Access Privileges for MDL M . 

• Sufficient disk storage. If you lack sufficient disk space on the machine to which you export the 
metadata, the export fails. Your destination machine must be able to contain the entire metadata 
file. The export utility cannot save portions of the metadata file. 

About the Metadata Export Utility 

You can export metadata from a Warehouse Builder repository using one of the following: 

• Metadata Loader command line utility. You can use the command line utility to perform tasks 
additional tasks not available from the client interface. For instructions on exporting from the 
command line, see "Using the Metadata Loader Command Line Utility" . 

• Warehouse Builder client interface. For instructions on using the client interface, see "Exporting 
Metadata" . 

Using the command line or the client interface, you can export an entire project, collection, or module, 
or any subset of objects. If you export a subset of objects, the MDL exports definitions for each object 
you have selected and the parent objects to which the subset belongs. This enables the MDL to maintain 
the tree relationships for those objects during metadata import. 

For example, if you export a single dimension, the export file contains definitions for: 

• The dimension (and its hierarchies and levels) 

• The dimension node to which the dimension belongs 

• The module to which the dimension node belongs 

• The project to which the module belongs 

If you are exporting a subset of objects, make sure you export all referenced objects and import them as 
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well. The Metadata Import Utility allows you to import repository objects even if the references for those 
objects cannot be satisfied. 

For example, if you export a cube, the foreign key references will be exported, but the dimensions to 
which they refer will not. If the metadata in the dimension tables changed, then the foreign key 
references imported to the new repository would become incorrect. 

Exporting Metadata using Warehouse Builder Client 

Use the metadata export utility to export objects from a Warehouse Builder repository into an MDL file. 
To export metadata from a repository using the Warehouse Builder client interface: 

1 . From the Warehouse Builder Console, select the object or objects you want to export. 

You can export individual objects such as tables or groups of objects. When you export projects 
nodes, or modules, you also export the objects they contain. When you export collections, you also 
export the objects they reference. 

2. From the Project menu, select Metadata Export and then File. 

The Metadata Export dialog displays the names and types of the objects you are exporting. The 
Metadata Export dialog also displays default settings for the export file as shown in Figure 14-3 . 



Figure 14-3 Metadata Export Dialog 



Metadata Export 



Items to be exported (Exporting using physical names) 




Name 




M0D1 


Warehouse Module 



File Name: 



ijjj 

d:\OWB_L\owb\bin\win32VMy Project-MOD1 Browse Files... | 



Log File: 







Field Separator: 
Character Set: 



d:\OWB_L\owb\bin\win32VLog 

,. 5; , 



Browse Logs... 



WE8MSW1N125: 







illll 



— 



Ill I! 



Help 



o j Export] Cancey 



Text description of the illustration meuexpmo.gif 



3. You can accept or change the following default settings: 
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• File Name: Type the name of the export file to create or click Browse to locate a directory 
or file. The filename you assign must end with .mdl. 

• Log File: Warehouse Builder records information about the export in a log file. You can 
change this location by entering a new path and filename. Type the path and file name in the 
field or click Browse to locate a directory or filename. 

• Field Separator: Table fields in the export file are separated with a pipe (|) by default. If 
your file already has the pipe (|) symbol as part of its data, you can change the default field 
separator to a caret ( A ) by selecting it from the list. 

• Character Set: Select the character set to use in the export file. The default character set is 
defined by the Warehouse Builder client system. Use the list to change the output character 
set. 

4. Click Export. 

If you made changes to the repository metadata prior to running the export utility, the Metadata 
Export Confirmation dialog displays. Click Commit to save changes or Rollback to revert to the 
previously saved version. You must have read-write access to the repository in which you are 
exporting metadata to commit changes. 

The Metadata Export Progress dialog displays the progress. When the export completes, the 
Metadata Export Results dialog displays. 

Click View Log File for a detailed view of the export process. 
Metadata Export File Format 

The Metadata Loader formats the .mdl export file using keywords and position as shown in 
Example 14-2 . 

Example 14-2 Sample Records from an Export File 

#Project data <PhysicalName> <LogicalName> <UniversalID> < Version Label> 
PROJECT | WarehouseName | Warehouse Name | A8 6184D5336911D58E9000B0D02A59E4 | null 
#Dimension <PhysicalName> <LogicalName> <UniversalID> <Prefix> <UsageType> <Import 
<Generated> 

DIMENSION | Channels | Channels Dimension Data 

Mart | 7E727 65502 9911D58DC900C04F4 8E9ED|ch|null |N|N 

In this example, each record in the file begins with a keyword followed by one or more 
variable-length fields. Table fields are separated by a pipe (|) by default. 

Archiving a Project 

Archiving a project allows you to copy metadata stored within a Warehouse Builder repository to 
an external location for the purpose of securing that data at a fixed point in time. Warehouse 
Builder provides an Archive Wizard to assist you in this process. The Archive and Restore utilities 
initially write to a file system. You can then move files from this file system into a third-party 
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Note: 

The Archive and Restore utilities will be desupported in the next release of 
Oracle9/ Warehouse Builder. 



You must set up your Archive/Restore settings on the Preferences page before you can archive or 
restore your project. If you attempt to archive or restore without setting these preferences, you get 
an error. 

Project Version Labels 

Before you archive your project, you can update the project version label with the Project 
Properties dialog. There are two places in Warehouse Builder where you can set up the version 
label used in the archive/restore: 

• The first is in the New Project Wizard. The New Project Wizard contains a step that allows 
you to define version properties. The version label that you set here is the version label that 
is used when that project is archived. 

• After you have created a project, you can edit the version label by opening the Properties 
dialog for the project. Click the Version Properties tab to modify the project version label. 

Differences Between Archive and Export 

Archive and Restore are different from Import and Export. Table 14-1 describes the differences 
between Archive and Export. 



Table 14-1 Differences Between Archive and Export 



Feature 


Archive 


Export 


Character Set 


UTF8 


User Configured 


Field Separator 


Pipe Character (|) 


User Configured 


Read-only 
Detection 


Detects and prompts you to re-try 


Detects and then fails 


Dump Format 


MDL 


MDL 
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Feature 



Archive 



Export 



Log File Name 



Generated 



Generated and User 
configured 



File Location 



Configured by preferences in the following 
structure: 



User-defined 



$ARCHIVE_HOME/ pro j ect_name/Label/ 
Archive Name 



Archiving a Project 

Before you archive your project, you can update the project version label with the Project 
Properties dialog (see "Project Version Labels") . 

To archive a project: 

1 . Select Archive from the Project menu. 

You can also select Archive from the right-click menu when a project is selected. 
The Archive Wizard Welcome page displays. 

2. Click Next 

The Summary page displays a summary of the archive settings prior to running the archive 
process. If you want to see the details of your archive after the archive process is complete, 
check the Show details dialog following a successful archive box. 

Figure 14-4 Archive Wizard Summary Page 
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Restore Wizard: Summary 




Summary ofRestore settings 




© Project j 

Label None 

Logical My Project 

Physical My Project I 

UOID 9E01 1 EFAD1 621 1 D48D71 00B0D02A59E8 
9 Archive 

Archiv... Thu May 03 17:43:24 PDT 2001 

Source D:\OWB_3001 1 0\owb\bin\admin\archive\PROJECTS\nolabel\My„Pro| 

Log D:\OWB_3001 1 0\owb\bin\admin\restore\log\R_My_Project_nolabelJ| 

Action Overwrite 





j > — . ^jShow details dialog Io^^s^^b^: , 

rz 'zzzmsssi i : ihii tzzz ie 11 

* *~ ~ . ****** 



Cancel j £ Help j 




. . ., ^ -I. ,„. ■ 

Nexi M ( Finish ) 



Text description of the illustration rest wiz.gif 



Note: 

No changes can be made from the wizard. If you notice an error in the Archive 
Wizard Summary page, click Cancel and make the appropriate changes to 
your Archive/Restore Preferences before continuing with the archive. 



3. Click Finish. 

This begins the archive process. A progress window appears. When the progress bar reaches 
100%, the archive process is complete. 

If you checked the Show details dialog following a successful archive box, the Archive Results 
dialog displays. This dialog displays the name of each object type and how many of each were 
archived. 



Figure 14-5 Archive Results 
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Archive Results 
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Text description of the illustration arch rsl.gif 

For a more detailed look at the archive process, click View Log File. This displays the 
entire log file. 

Figure 14-6 Archive Log File 
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******************************************************************************** 

* Export from OTJB Release: 3.0.0.11.0 Version: 3.0.0.1.0 

* User: owb3i_salison Connect String: (DESCRIPTION (ADDRESS*: (H0ST=dwqalab37-pc) 
(PR0T0C0L=tcp) (P0RT=1521) ) ( C ONNE CT_D ATA= ( S ID = owb qa8 1 7 ) ) ) 

* Data File: D: 
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Importing Metadata 

The import utility reads the metadata information from an exported text file and inserts the 
metadata objects into a repository. The metadata import utility only reads files created by the 
metadata export utility. 
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The MDL imports information belonging to exported metadata objects such as table columns and 
their constraints, data loading configuration parameters, and named attribute sets. You can use the 
MDL to import objects into a project or a collection. 

The following sections describe how to use the Metadata Import Utility: 

• Before Importing Metadata 

• About the Metadata Import Utility 

• Validation Rules Governing Import 

• Importing Metadata using Warehouse Builder Client 

• Restoring a Project 

Before Importing Metadata 

Before you attempt to import metadata, ensure you have the following: 

• Required security privileges: You need the MDLIMPORT privilege before you begin an 
import. For more information on security, see "Managing Security with PL/SQL" . 

• Required access privileges: Only a user with read/write access can use the metadata loader 
import utility. Because the import utility is altering the repository, the metadata objects must 
be locked prior to importing. For more details, see "Required Access Privileges for MDL" . 

• A backup of your current repository: Consider taking a backup of your existing 
repository (either in the form of an export or a metadata snapshot) before attempting a large 
or complex import. For more information on exporting metadata, see "Exporting Metadata" . 
For more information on metadata snapshots, see Chapter 15, "Metadata Change 
Management" . 

• Multiple Language Support base language compatibility: The base language is the 
default language used in the repository and is set using the Repository Assistant during 
installation. This setting cannot be altered after installing the repository. Loading differing 
base language metadata objects into a repository results in error. For more information on 
setting the base language in a repository, see the Oracle9i Warehouse Builder Installation 
and Configuration Guide. 

About the Metadata Import Utility 

You can import metadata into a Warehouse Builder repository using one of the following: 

• Metadata Loader Command Line Utility: You can use the command line utility to 
perform tasks additional tasks not available from the client interface. For example, you can 
override default values for configuration parameters for loading data. For instructions on 
importing from the command line, see "Using the Metadata Loader Command Line Utility" . 

• Warehouse Builder Client Interface: For instructions on using the client interface, see 
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"Importing Metadata" . 

Validation Rules Governing Import 

When you import a set of definitions from exported metadata, the import utility can update 
existing definitions in a Warehouse Builder project. However, certain metadata definitions require 
attention to ensure that they are updated. The following are examples of some of the errors you 
can see: 

• Mapping Definitions. The Metadata Import Utility does not bind imported mapping 
operators to their physical objects. If a mapping definition appearing in the source MDL file 
replaces a mapping definition in the target repository, then the new repository mapping 
definition is unbound. You may need to reconcile new mapping operators with the physical 
objects they represent. The MDL generates a warning message to the log file stating that the 
mapping operators are not bound. 

• Foreign Key Definitions. It is possible that a source MDL file can contain foreign key 
references to unique or primary keys that are not in the target repository. If the referenced 
unique or primary keys for any foreign key appearing in the MDL file does not exist in the 
target repository, the MDL will generate a warning message in the log file. This message 
will state that the repository does not contain a referenced key for the foreign key. 

Importing Metadata using Warehouse Builder Client 

Use the metadata import utility to import objects from an MDL file into a Warehouse Builder 
repository. 

To import objects from an export file using the Warehouse Builder client: 

1 . Select the project to which you will import metadata. 

2. From the Warehouse Builder Console, select Project and select MetaData Import. 
Warehouse Builder displays the Metadata Utility Import dialog as shown in Figure 14-7 . 

Figure 14-7 Metadata Import Utility 
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Text description of the illustration miupsibn.gif 

3. Specify the names and locations for the import file and its log: 

• File Name: Type the name of the MDL file or click Browse to find the MDL file you 
want to import. 

• Log File: Warehouse Builder records information about the import in a log file. You 
can change this location by entering a new path and filename. Type the path and file 
name in the field or click Browse to locate a directory or filename. 

4. Select an Import Option. For more information on import options, see "Import Modes" . 
You can select from the following import options: 

• Add new metadata only: Adds new objects to a repository. 

• Add new metadata and replace existing objects: Adds new objects to a repository 
and replaces existing objects. 

• Add new metadata and merge existing objects: Adds new objects and merges 
columns into existing objects in your repository. 
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• Replace existing objects only: Replaces existing objects in your repository. 

5. In Match By, specify the matching criteria the utility uses to compare the metadata in the 
import file against the metadata existing repository. For more information, see "Metadata 
Matching Criteria" . 

• Ignore Universal Identifier: The import utility does not use Universal Identifiers to 
search for objects you are importing. 

• Name: Searches your repository using the physical names of the objects you are 
importing to make sure the objects do not already exist. 

• Character Set: Select the type of character set used to create the import file. The 
default character set is defined by the Warehouse Builder client machine. Use the 
drop-down list to change the output character set. 

You can add new languages and character sets using the Repository Assistant. For 
more information, refer to the Oracle9i Warehouse Builder Installation and 
Configuration Guide, 

6. Click Scan to display the exported metadata header information as shown in Figure 14-8 . 
The Header Information dialog displays a summary of the total number of object types 
contained in the metadata file you selected. 



Figure 14-8 Header Information 




Project = GCCUarehouse 

Entity in Project 
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DATAUAREHOUSE: 
TABLE: 



Added 



llllllllllll 
... 




J. 



Text description of the illustration miuimpsc.gif 



7. Click Import. 



If you have made any changes before starting the import, the Metadata Import 
Confirmation dialog displays. Click Commit to save any changes or Rollback to 
ignore changes and revert to the previously saved version. 

The Metadata Import Confirmation dialog displays as shown in Figure 14-9 if the 
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exported metadata data information has not been reviewed. 
Figure 14-9 Metadata Import Confirmation 
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Text description of the illustration mdi conf.gif 
8. Click Import to continue. 

The Metadata Import Progress panel displays. 

Figure 14-10 Metadata Import Results 
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This dialog displays the object types and the number of each type that were imported 
or skipped. For a detailed view of the import process, click View Log File. 

Import Modes 

The graphical user interface for the metadata import utility operates in one of the following 
modes: 

• Add new metadata only (Create Mode): Adds new objects to a repository. If objects 
from the MDL file already exist in the repository, they remain unchanged. 

• Add new metadata and replace existing objects (Update Mode): Adds new objects 
to a repository and overwrites existing objects with those in the MDL file. 

• Add new metadata and merge existing objects (Merge Mode): Adds new objects 
and overwrites existing objects in your repository only if they differ with those in the 
MDL file. 

• Replace existing objects only (Replace Mode): Replaces only existing objects in 
your repository. When importing metadata objects, the MDL will overwrite any 
existing metadata unless you use this mode. 

When you import using the Update or the Replace modes, the import completely replaces 
the existing object's children so that the final object is exactly the same as the source object. 
Any existing children of a repository object that are not replaced or added are deleted. This 
occurs regardless of whether a child object occurs in a mapping or is a foreign, primary, or 
unique key column in a table or view. 

For example, in the MDL export file, the CUST table contains three columns with the 
physical names: LastJNfame, First_Name, and Middle_Init. In the repository, the same table 
already exists, and contains four columns with the physical names: Last_Name, First_Name, 
Status, and license_ID. During a replace operation, the columns Last_Name and First_Name 
are replaced, column Middle_Init are added, and column Status and license_ID are deleted. 
The final result is that the CUST table in the Warehouse Builder repository contains the 
same metadata from the CUST table in the export file. 



Tip: 

Using the replace mode can result in lost data constraints, metadata 
physical property settings, data loading properties, and mapping 
definitions. If you choose to use replace mode, ensure that you can restore 
your repository from backup to its state prior to importing in replace 
mode. 



Metadata Matching Criteria 

When you use the metadata import utility, it first searches the repository for metadata 
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objects that exist in the repository and compares them to those in the file you are importing. 
How the comparison is made is determined by the loading mode and by the search method 
you choose. The following methods are available: 

• Physical Name: Physical names are exported to the export file. The physical name 
determines whether an object needs to be created, replaced, or merged during an 
import operation. Use this method when object names in the target directory change, 
and you want to create new UOIDs for those objects. 

• Universal Object Identifier: The metadata export utility assigns a unique 
system-generated identifier to each exported row object called the Universal Object 
Identifiers or UOIDs. The purpose of the UOID for a row object is to uniquely 
identify it in an object table. The MDL import utility uses these UOIDs to determine 
whether a row object needs to be created, replaced, or merged during an import 
operation. Use this method if you want to maintain UOIDs across different 
repositories even when object names in the target repository have changed. 

By default, the import utility searches by UOIDs. However, the import utility ignores the 
UOIDs for mappings in the MDL file that already exist in the target repository. 



Note: 

MDL imports that run in merge mode must use UOIDs for the search 
criteria in order to merge into existing mappings. Also, if the mapping in 
the MDL file does not have a Universal Identifier, the mapping cannot be 
merged into a mapping that matches by name. For more information, see 
"Import Modes" . 



Each search method can be combined with an import mode in several different 
combinations. Each combination can offer different results in the import process. The mode 
that you select determines how the metadata import utility will search for metadata objects 
in the repository prior to importing. 

For example, if the search is by the logical name of a repository object in the export file, the 
Metadata Import Utility searches the repository for the object's logical name. If an object 
with the corresponding logical name is not found, the resulting actions are based on the 
import mode you select. 

Table 14-2 describes what happens in the available import modes for repository objects that 
do not match the MDL file names. 



Table 14-2 Import Mode without Matching Names 



Import 




Mode 


Result 


Create 


A new object is created. 
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Import 

Mode Result 

Mode 



Replace A warning message is written to the log file that the object cannot be found to 
Mode replace and the object is skipped. 



Update A new object is created. 
Mode 



Merge A new object is created. 
Mode 



Table 14-3 describes what happens in the available import modes for repository objects that 
match the MDL file names. 

Table 14-3 Import Mode with Matching Names 



Import 

Mode Result 



Create Mode A message is written to the log file that the object already exists and the 
object is skipped. 

Replace The object is replaced. 
Mode 



Update Mode The object is replaced. 



Merge Mode The object is merged. 



The MDL reads and processes the imported metadata and writes status and diagnostic 
information in the log file. When the import is complete, the Metadata Import Results dialog 
displays. 

Restoring a Project 

Restoring a project allows you to recreate metadata within a Warehouse Builder repository 
from an external location. Warehouse Builder provides a Restore Wizard to assist you in 
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this process. 



Note: 

The Archive and Restore utilities will be desupported in the next release 
of Oracle9z Warehouse Builder. 



You must set up your Archive/Restore settings on the Preferences page before you can 
archive or restore your project. If you attempt to archive or restore without setting these 
preferences, you get an error. 

Differences Between Restore and Import 

Archive and Restore are different from Import and Export. Table 14-4 describes the 
differences between Restore and Import. 

Table 14-4 Differences Between Restore and Import 



Feature 



Restore Import 



Character Set 



UTF8 User Configured 



Complete Project 
Replacement 



Yes Does not delete the project; may replace it, depending 
on MDL mode 



Dump Format 



MDL MDL 



UniversallD 
Preservation 



Always User Configured 



Name Preservation Always User Configured 



Log File Name 



Generated Generated and User configured 



Mode 



Replace Create/Update/Replace/ Merge 
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Follow these instructions to restore a project. 

To restore a project: 

1 . Select Restore from the Project menu. 

The Restore Wizard Welcome page displays. 

2. Click Next. 

The Select Archive page displays. Browse to or type the Archive File you want to 
restore. 

Figure 14-11 Select Archive Page 



Restore Wizard: Select Archive 




Text description of the illustration rest wia.gif 
3. Click Next. 

The Summary page displays a summary of the restore settings prior to running the 
restore process. If you want to see the details of your restore after the restore process 
is complete, check the Show details dialog following a successful restore box. 

Figure 14-12 Restore Wizard Summary Page 



23 of 40 



5/9/2007 4:18 PM 



Importing and Exporting with the Metadata Loader (MDL) 



i 

http://download-west.oracle.eom/docs/html/B 1 0657J) 1 / 1 4import.ht.., 



Restore Wizard: Summary 




Text description of the illustration rest wiz.gif 
4. Click Finish. 

This begins the restore process. A progress window appears. When the progress bar 
reaches 100%, the restore process is complete. 

If you checked the Show details dialog following a successful restore box, the Restore 
Results dialog displays. This dialog displays the name of each object type, how many 
of each were restored, and how many of each were skipped. 

Figure 14-13 Restore Results 
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£ Restore Results 
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Text description of the illustration rest rsl.gif 

For a more detailed look at the archive process, click View Log File. This displays 
the entire log file. 

Figure 14-14 Restore Log File 



M L °9 F < le 



■Mm, 



Import started at 05/03/2001 6:21:09 PH 

******************************************************************************** 

* Import for 0UB Release: 3.0.0.11.0 Version: 3.0.0.1.0 

* User: owb3i_salison Connect String: (DESCRIPTION (ADDRESS= (H0ST=duqalab37-pc) 
(PR0T0C0L=tcp) (P0RT=1521) ) ( C 0NHE CT_D ATA= ( S ID = owb qa8 1 7 ) ) ) 

* Data File: D:\0DJB_300110\oub\bin\admin\archive\PR0JECTS\nolabel\Hy_Project\pro3 
mdl 

* Log File: D: 




Text description of the illustration rest log.gif 

Using the Metadata Loader Command Line Utility 

You can operate the MDL from the command line instead of the user interface. 
This section contains the following topics: 

• Creating MDL Parameter Files at the Command Line 
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• Exporting Metadata Using the Command Line Utility 

• Importing Metadata Using the Command Line Utility 

For related information on using the Metadata Loader's command line utility for upgrade 
purposes, refer to the Oracle9i Warehouse Builder Installation and Configuration Guide, 

Creating MDL Parameter Files at the Command Line 

If you use the command line interface, you can customize how to move your metadata at a 
more detailed level than you can when using the GUI. For example, when exporting 
metadata, the command line allows you the flexibility to disable the export of configuration 
values, vary the separator character within an export file, and maintain parameter files for 
selected export operations. 

For importing metadata, the command line offers the flexibility of creating specific import 
actions for each object. These operations automate the consolidation or synchronization of 
metadata in multiple repositories that have a similar project structure. 

The scripts for executing both the export and import utilities reside in the 
$0WBH0ME\owb\bin\win32 directory. Both the export and import utilities are driven by a set 
of parameters. You can specify the MDL parameters by: 

• Providing MDL parameters as a response to command-line prompts. 

• Creating an MDL parameters file. 

• Providing MDL parameters as a response to command-line prompts, and create a 
MDL parameters file. 

Exporting Metadata Using the Command Line Utility 

By default, the MDL also exports values for configuration parameters for loading data, but 
you can override this setting at the command line. You can choose how you want to export 
the files within a project. For example, if you are exporting three source modules and two 
target modules, you can choose to export them separately or together. 

To export a project at the command line: 

1 . Create the MDL parameters file. 

2. Execute the Metadata Export Utility. 

The following command invokes the Metadata Export Utility and specifies the above 
parameters file: 

w: \owb\bin\win32>exp par f ile=e : \MDL\EXP_Di recti ves 
Processing ... Export successful. 



The objects are exported to the file and can be imported into a repository using the 



26 of 40 



5/9/2007 4:18 PM 



Importing iind Exporting with the Metadata Loader (MDL) 



http://download-west.oracle.eom/docs/html/B 1 0657_0 1 1\ 4import.ht.. 



metadata import utility. 
Keywords for the Export Utility 

An MDL parameters file is a text file that contains a set of parameters for the export utility. 
The format for an export parameter is: 

Keyword=Value 

You can also form an export parameters by replacing the value with the wildcard character 
(*), which matches any string, or with a list of named objects: 

Keyword=* 

Keyword=(value-1, value-2, -k) 

For example, you can specify a set of tables to be exported as: 

TABLES= (Customers, Products, Days) 

Example 14-3 shows a typical parameters file for importing a module. 
Example 14-3 Parameters File format 

USERI D=GCCWH/GCCWH@dwdocl 1-pc : 1 52 1 : ora8 1 6 

PROJECT=GCCWarehouse 

FILE=e : \MDL\GCCWarehouse-exp- JUL01 

FIELDSEPARATOR=| 

LOG=e : \MDL\GCCWarehouse-exp- JUL01-LOG 
CONFIGPARAM=N 

Table 14-5 summarizes the keywords used to form export parameters. You can use the 
comment indicator (#) to document the scripts. Put the indication in the first column of a 
record and follow it with text. 

Table 14-5 Keywords for Export Utility Parameters 



Utility Prompt Keyword Descriptic 



Username/password@host:port:sid USERID Username, 

password ar 
connection ; 
string. 



N/A USERNAME The user nai 

for accessin 
Warehouse 
Builder 
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Utility Prompt Keyword Descriptio 

repository. 



N/A PASSWORD The passwo 

that corresp- 
to the 

USERNAM 



N/A HOST Machine na 

for Warehoi 
Builder 
repository. 



N/A PORT Port for 

Warehouse 
Builder 
repository 
database lisi 



N/A SID SID for 

Warehouse 
Builder 
repository 
database. 



Project Name . PROJECT Project nam 

Wildcard fo 
supported ft 
Project, but 
used, no oth 
object type 
keywords cz 
follow. In o: 
to export sh 
transformati 
use 

PR0JECT-G1 
Shared. 



Export File FILE File name ft 

exported da 
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Utility Prompt 



Keyword 



Descriptio 



Field Separator 



FIELDSEPARATOR 



Field separa 
I, A or-. 



Log File 



LOG 



File name ft 
status and 
statistics of 
export. 



Parameter File 



PARFILE 



Parameter fi 

containing 

keywords. 



N/A 



CONFIGPARAM 



Export 
configuratio 
values (Y/N 
Default is Y 



N/A 



TRACE 



Debug 

messages. 

Options: 

S - write 
messages to 
screen 
Y - write 
messages to 
file 

B - write 
messages to 
screen and z 



N/A 



TRACEFILE 



Trace file n; 



N/A 



PHYSICALNAMES 



Use physica 
names (Y/N 
lookup of 
objects to bi 
exported. 
Default is N 
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Utility Prompt Keyword Descriptio ■ 

N/A CHARACTERSET Thecharact 

to be used fi 
the export d 
file. 



N/A MODULES If a wildcan 

multi-value 
format is us 
for MODUI 
no other obj 
type keywoi 
can follow, 
simple form 
used, this 
keyword cai 
appear mult 
times, direci 
followed by 
keywords fc 
any of its o\ 
object types 
which can b 
selected usii 
any format 
(simple, 
wildcard, 
multiple). 



N/A 


TABLES 


N/A 


N/A 


VIEWS 


N/A 


N/A 


FILES 


N/A 


N/A 


SEQUENCES 


N/A 


N/A 


MATERIALIZED VIEWS 


N/A 
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Utility Prompt 


Keyword 


Descriptio 


N/A 


DIMENSIONS 


N/A 


N/A 


FACTS 


N/A 


N/A 


TRANSFORM 
CATEGORIES 


For wildcari 
multi-value 
format, no 
FUNCTIOh 
keyword cai 
follow. If si. 
format then 
keyword cai 
appear mult 
times, direci 
followed by 
FUNCTIO> 
keyword, w! 
can use any 
iormai ^sim 
wildcard, 
multiple). 


N/A 


FUNCTIONS 


N/A 


N/A 


MAPPINGS 


N/A 


N/A 


COLLECTIONS 


N/A 


N/A 


LOCATIONS 


N/A 


N/A 


CONNECTORS 


N/A 


N/A 


RUNTIMEREPOSITORYCONNECTIONS N/A 


N/A 


STAND ALONEFUNCTIONS 


N/A 
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Utility Prompt 


Keyword 


Descriptic 


N/A 


STAND ALONEPROCEDURES 


N/A 


N/A 


ADVANCEDQUEUES 


N/A 


N/A 


EXTERN ALTABLES 


N/A 


N/A 


PROCESSES 


N/A 


N/A 


SNAPSHOTS 


N/A 


N/A 


QUERYOBJECTS 


N/A 


N/A 


REPORTS 


N/A 


N/A 


REPORTGROUPS 


N/A 


N/A 


IOBUSINESSAREAS 


N/A 


N/A 


HELP 


Use HELP= 
for a comph 
list. 


N/A 


# 


Comment li 
used in a 
parameter fi 



Importing Metadata Using the Command Line Utility 

To import selected modules: 

1 . Create an MDL parameter file. 

2. Execute the Metadata import utility. 

The following command invokes the Import Utility and specifies the above MDL 
parameter file: 



32 of 40 



5/9/2007 4:18 PM 



Importing^and Exporting with the Metadata Loader (MDL) 



http://dov^load-west.oraclexom/docs/html/B10657_01/14import.ht.. 



w: \owb\bin\win32>imp parf ile=e : \MDL\IMP_Directives . txt 
Processing . . . 
Import successful. 

Keywords for the Import Utility 

Like the MDL export, you can direct the MDL import to import objects from a file by 
answering prompts or by creating a file with a set of parameters. Example 14-4 shows a 
typical parameters file for importing a module. 

Example 14-4 Parameters File format 

USERI D=GCCWH/GCCWH@dwdocl 1-pc : 1 52 1 : ora8 1 6 

FILE=e : \MDL\gccstar-exp 

LOG=e : \MDL\gccstar-imp~LOG 

MODE=CREATE 

CON FI GPARAM=N 

Table 14-6 summaries the keywords used to form import parameters. 



Table f 4-6 Keywords for Import Utility Parameters 



Utility Prompt Keyword 


Description 


Username/passw@host:port:sid USERID 


Username, password and 
connection as a string. 


N/A USERNAME 


The user name for accessing 
Warehouse Builder 
repository. 


N/A PASSWORD 


The user password that 
matches USERNAME. 


N/A HOST 


Machine name for 
Warehouse Builder 
repository. 


N/A PORT 


Port for Warehouse Builder 
repository. 


N/A SID 


SID for Warehouse Builder 
repository. 
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Utility Prompt 


Keyword 


Description 


Import File 


FILE 


File name for the data to be 
imported. 


Import Mode 


MODE 


CREATE, REPLACE, 
UPDATE, or 

INCREMENTALUPDATE. 


Log File 


LOG 


File name for the status and 
statistics of the export. 


Parameter File 


PARFILE 


Parameter file containing 
keywords. 


N/A 


CONFIGPARAM 


Import configuration values 
(Y/N). Default is Y. 


N/A 


TRACE 


Debug messages. Options: 

S - write messages to screen 
Y - write messages to a file 
B - write messages to screen 
and a file 


N/A 


TRACEFILE 


Trace file name. 


N/A 


PHYSICALNAMES 


Use physical names (Y/N) to 
lookup objects to be 
imported. Default is Y. 


N/A 


CHARACTERSET 


The character set to use for 
the export data file. 


N/A 


HELP 


Use HELP=Y for a complete 
lis.t 
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Keyword Description 



N/A 



# 



Comment line used in a 
parameter file. 



N/A 



IGNOREUniversallD 



Ignore (Y/N) the universal id 
as the search criteria. 
Default is N. 



N/A 



PRESERVEDESCRIPTION Preserve the description 



(Y/N) of already existing 
objects if the MDL data file 
does not have a description 
for the object. Default is N. 



N/A 



SINGLEUSER 



Request a single user lock 
(Y/N) for running the 
import. Default is N. 



If a MODE parameter is not included, then the default is CREATE. 

In addition to running an MDL parameter file from the import utility, you can also specify 
an action plan within the file that will allow you to specifically define what you want to do 
with each object in the imported file. First you need to specify if you want the object 
imported, skipped, or deleted. If you choose to import the object, you can set the import 
mode to CREATE, UPDATE, REPLACE, or INCREMENTAL UPDATE. 

Example 14-5 shows an example of an MDL parameter file that contains an action plan. 
Example 14-5 MDL Action Plan 

USERID=user_sample/user_sample@test-pc : 1521 : ora8i 
# 

FILE=e : \test\data\sample_f ile .mdl 
LOG= e:\test\log \ imp_s amp 1 e_f i 1 e . 1 og 
# 

MODE=ACTIONPLAN 
PHYS ICALNAMES=Y 
IGNOREUOID=Y 
# 

# User-Specified Action Plan 
# 

ACTION=NONE 
PROJECT=MY PROJECT 
MODULES= (DATAWAREHOUSE) 
# 

ACTION=CREATE 
TABLES=(TABLE_3) 
FACTS=(FACT1, FACT 2 , FACT 3 ) 
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SEQUENCES- (SEQ_A, SEQ__B, SEQ_C) 
# 

ACTION-REPLACE 

TABLES= ( TABLE_1 , TABLE_2 ) 

DIMENSIONS- (DIM1, DIM2, DIM3) 

# 

ACTION=DELETE 
TABLES- ( TABLE_A, TABLE_B ) 

# 

# Switching to a different module 

ACTION=REPLACE 

MODULES- (FLAT_FILE) 

FILES= ( FILE_1 , FILE_2 ) 

# 

ACTION=CREATE 

FILES=(FILE_3) 

# 

ACTION-DELETE 
FILES- (FILE_X) 

Splitter for Exporting and Importing Warehouse 
Builder Mappings 

The Split utility provides a workaround for the memory limitations of the MDL import 
utility when you are importing a large number of mappings. This utility generates export and 
import scripts for migrating mappings in pieces as opposed to migrating them all at the 
same time. The generated scripts have matching MDL parameter files that utilize the 
create mode. These files can be edited. 

If the MDL import fails because of large data, the split utility can be used to re-export and 
import the mapping data in smaller pieces. All other object types must be exported and 
imported using the standard MDL utilities. Only mappings can be split into smaller pieces. 
To export all entities other than mappings, a parameter file containing the following can be 
used: 

• VIEWS=* 

• TABLES=* 

• SEQUENCES-* 

• MATERIALIZEDVIEWS-* 

• CUBES-* 

• FILES-* 

• DIMENSIONS-* 

• VIRTUALTABLES-* 

• TEMPORARYTABLES-* 

• TRANS FORMCATEGORIES-* 
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The split utility splits the mappings within a module in a Warehouse Builder project. The 
size of the pieces is determined by a parameter located in a file provided with this 
application. 

The expsplit batch script accepts the following arguments: 

• A parameter file, specified in the form c : \temp\owb_apps . txt. The parameter file 
has special keywords outlined below that identify the number of mappings, data file 
names, and extensions. 

• A parameter target file prefix, specified in the form c : \temp\owb_apps the piece 
number (numbered from 1). A . txt suffix is added to the generated parameter file, a 
. bat suffix is added for the export batch file, and an _imp . bat suffix is added to the 
import batch file. 

The following is an example of how to start the split utility: 

expsplit exampleparams.txt c:\temp\ora_apps 

The following example uses a parameter file exampieparams . txt. This file contains the 
following parameters: 

• userid=apps/apps@130 .35.12.73: 1521 : orclO 

• PHYSICALNAMES=Y 

• LOG=c : \temp\owb_data_apps 

• LOGEXT=log 

• FILE=c: \temp\owb_data_apps 

• FILEEXT=dat 

• FIELDSEPARATOR=" 

• PROJECT=EDWPRJ 

• MODULE S=EDW_COMMON_MODULE 

• TYPE=MAPPINGS 

• COUNT=70 

This file is similar to the export parameter file for Warehouse Builder Metadata Loader, 
with the changes listed in Table 14-7 . 

Table 14-7 Split Utility Export Parameter Keyword Descriptions 
Keyword in Description 
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Parameter File 



FILE 



Prefix of data file, the chunk number, and file extension 
(FILEEXT) define the data file name where you exported the 
data. 



FILEEXT 



The data file extension. 



PHYSICALNAMES Used for name matching. 



LOG 



Prefix of the log file, the chunk number, and file extension 
(FILEEXT) define the log file name. 



LOGEXT 



The log file extension. 



PROJECT 



A single project name must be specified. 



MODULES 



A single module name must be specified. 



TYPE 



Must be MAPPINGS. 



COUNT 



The number of mappings to be written to each export chunk. 



If the mappings for a Warehouse Builder project are split, the generated parameter files are 
named as follows: 



owb_appsl . txt 
owb_apps2 . txt 



A batch file is generated: c : \ temp\owb_apps . bat (given the parameter target file prefix) to 
export the data from the repository. An import batch file is created to import, using create 
mode, into the same repository. These files can be edited if different target databases are 
required. 

To migrate data using the split utility: 

1. Using command line or Warehouse Builder, perform MDL export of all objects other 
then mappings. 

To export all objects other than mappings in a command line, use a parameter file 
with the following keywords: 
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VIEWS-* 

TABLES-* 

SEQUENCES-* 

MATERIALIZE DVTEWS=* 

FACTS-* 

FILES-* 

DIMENSIONS-* 

VIRTUALTABLES-* 

TEMPORARYTABLES-* 

TRANS FORMCATEGORIES-* 

If you are using Warehouse Builder to perform export, use multi-select to select and 
export objects other than mappings. 

2. Import the new export file into target repository. 

3. Split the mappings and export them using split utility 

expsplit exampleparams.txt c:\temp\ora_apps 

The utility connects to the source repository, splits mappings, and creates multiple 
parameter files according to exampieparams . txt. These parameter files are used 
during the export. The utility also creates an export batch file and an import batch file. 

Table 14-8 lists the files that are created. 
Table 14-8 Files Created by the Split Utility 

Description File Name 

Batch file to perform export c:\temp\ora_apps.bat 

Batch file to perform import c:\temp\ora_apps_imp.bat 
ftfcf^ISftiSsfite (variable FILE specified in step 3). 

c:\temp\ora_apps2.txt 
5. Modify generated parameter files c : \temp\ora_appsi . txt, 

c : \temp\ora_apps2 . txt. Edit the connection information ta^Qnjb\terjkhailpBgetxt 
repository. 
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6. Run import batch file c : \ temp\ora_apps_imp . bat to complete the import. / 
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Managing Warehouse Builder Browser 



Warehouse Builder Browser integrates with Oracle Portal to enable you to add and customize 
Warehouse Builder portlets. The Warehouse Builder Browser uses Warehouse Builder Public Views to 
create pre-built reports on all repository objects and relationships between objects. You can also use the 
Public Views to create your own custom reports. 

This chapter contains the following information: 

• Warehouse Builder Browser Overview 

• Adding Portlets 

• Administering Warehouse Builder Browser 

• Creating Custom Reports 



Warehouse Builder Browser is a web based application that you can use to extend, access, and run 
reports on your repository metadata. To view the metadata and access these reports, you must have 
access to Oracle9/AS Portal. 

When you first install or upgrade Warehouse Builder, you can use the Warehouse Builder Browser 
Assistant available on the start menu to install the Warehouse Builder Browser. The Browser Assistant 
enables you to set up an Oracle9/AS Portal from which you can access and create metadata reports. You 
can run the Browser Assistant during your installation process or defer it to a later time. 

After Warehouse Builder Browser is installed, you can add the Warehouse Builder portlets to your Portal 
home page. You can run Metadata reports using the Browser from either the Warehouse Builder client or 
Oracle Portal. 

About Oracle9/AS Portal 

Oracle9/AS Portal enables you to create and view database objects using an HTML-based interface. It 
provides tools for creating HTML-based interfaces. Portal provides you with a centralized and 
personalized view of relevant applications and data in a single web site. 
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The fundamental building blocks of an Oracle9/AS Portal site are called portlets. A portlet is a re-usable 
information component that summarizes or provides access to an information source. Portlets can stand 
alone in a Portal site, link to other portlets or portal sites, or they can be nested within one another. 

Warehouse Builder Browser integrates with Oracle9/AS Portal to obtain metadata reporting portlets. 

Portlets for Managing Warehouse Builder Browser 

The Warehouse Builder Browser consists of portlets that you can add to customize your portal page. You 
can add more than one of each portlet. For example, you can add two Reports portlets with each running 
a report on a different repository. 

The portlets used for managing Warehouse Builder Browser include the following: 

• Launcher Portlet 

• Administration Portlet 

• Reports Portlet 

To access any portlet, you must first configure the Warehouse Builder Browser to access a Warehouse 
Builder Design Repository. 

You can also add custom portlets to suit your business intelligence needs. For more information, see 
"Adding Portlets" . 

Launcher Portlet 

The Launcher Portlet provides access to all the available functions. Other portlets contain subsets of all 
available functions. 

• Browse a Repository: Select a role and click Browse to browse the repositories available to the 
current user. The main Warehouse Builder Browser page displays in full page mode. You can 
select from a list of repositories, and use the Navigator to view the detail of that repository. 

• Browse My Favorites: Select this link to view your Warehouse Builder Favorites in full page 
mode. 

• Administer Warehouse Builder Browser: Select this link to view the Warehouse Builder 
Administration in full page mode. Use these pages to configure your Browser. 

Figure 17-1 Launcher Portlet 
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Browse a Repository 

Select a role and click Browse. 



Role [ QA User 




Browse My Favorites 

Choose from a list of your Navigation and Report Favorites. 
Administer Warehouse Builder Browser 

Perform administrative functions such as registering repositories and granting 
access to users. 



Text description of the illustration laun poa.gif 
Administration Portlet 

The Administration Portlet provides access to the following Administration features from your Oracle 
Portal home page: 

• Register an OWB Repository: Register Warehouse Builder repositories and maintain database 



• Register a Custom Report: Register custom reports. 

• Purge Stale User Information: Purge obsolete Warehouse Builder Browser settings. 

• Resource Management: Manage access privileges to Warehouse Builder Browser resources. 

• Manage Preferences: Save and load preference settings from files or an existing schema. 

• Manage Dependency Index: Improve performance of Impact Analysis by specifying how often 
to refresh the Dependency Index. 

Figure 17-2 Administration Portlet 



links. 
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Add Portlets - Microsoft Internet Explorer 



Edit View Favorites. Joels .Help . 

. - 



Add Portlets 




Add Portlets To Region 

Drill down to the appropriate provider, then click the portlet name to add the portlet to this region. 



H&lab!«Portl«t..;..: 



sleeted 



General 



QWBBLONDON2 - 
Warehouse Builder 

Browser ^ 

The Launcher portlet for the 
Oracle Warehouse Builder 

Browser application 

The Reports portlet for the 
Oracle Warehouse Builder 

Browser application 

QWBBLONDQN2- 
Warehouse Builder 
Administration Q± 

The Administrator portlet for the 
Oracle Warehouse Builder 

Browser application 



OWBBLQNDON2 - 
Warehouse Builder 
Navigator <^ 

The Navigation Portlet for the 
Oracle Warehouse Builder 

Browser application 

OWBBLQNPON2 - 
Warehouse Builder 
Favorites 

The Favorites portlet for the 
Oracle Warehouse Builder 

Browser application 



OWBBLONDON2 -Warehouse Builder B 
OWBBLONDON2 -Warehouse Builder N 
OWBBLONDON2 - Warehouse Builder R 



® 



Portlet Repository : Other Providers : OWBBLONDON2 
Warehouse Builder Provider 



Text description of the illustration addport.gif 



Reports Portlet 



The Reports Portlet displays a Warehouse Builder Report on your Oracle Portal home page. The Reports 
Portlet displays one of your favorite reports. When you first add this portlet to a page, it does not contain 
a default report. You must first use the customize option to select and add a report from you favorites 
list. 

When you have a Reports portlet on your Oracle Portal home page, it refreshes each time you reload the 
home page. This can delay the home page display. 
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Figure 17-3 Reports Portlet 



Warehouse Builder Reports 



Customize Help About 



Add to My Favorites Full Page 



Detailed Table Report - DAYS 



Business Name DAYS 

Physical Name DAYS 
Description 

The DAYS tables contains columns for date specific information. 

Module MODULE GROCERY Project 

Validation Result Yes 

Columns 



Created On 
Updated On 



GROCERY 



11- DEC-02 

12- DEC-02 




Day_WH 



DAY WH 



NUMBER 



E 



Day_description 



DAY DESCRIPTION. 



DATE 



Day of Month 



DAY OF MONTH 



NUMBER 



Day of year 



DAY OF YEAR 



NUMBER 



0 



Month ID 



MONTH ID 



NUMBER 



Month number 



MONTH NUMBER 



NUMBER 



Month description 



MONTH DESCRIPTION 



VARCHAR2 9 



Text description of the illustration 13 5a.gif 

Adding Portlets 

Warehouse Builder Browser portlets can be added to Oracle Portal after they have been installed on the 
machine running Oracle Portal. 

For information about customizing Oracle Portal pages, see the Oracle Portal documentation. 
To add a portlet to a page: 

1 . From the Oracle Portal page, select the Edit Page link from the upper-right corner of the page. 
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The Edit Page displays the contents of the Oracle Portal page. 
Figure 17-4 Oracle Portal Edit Page 



Portlets 



Edit Page: Warehouse Builder Development 




Modify the Contents of the Page 

Add portlets to a region, or remove or edit existing portlets. You can also add, 
delete, or edit regions and tabs, and edit the page banner. 



Actions: 



Hide] rshovv j j Delete ] Move ] 



Banner 



Edit Defaults 



Text description of the illustration 14 6.gif 

2. Select the Add Portlets icon. 

The Add Portlets page displays a list of available portlets on the left side, and a list of selected 
portlets on the right side. 



Figure 17-5 Add Portlets Page 
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'5 Add Portlets - Microsoft Internet Explorer 



Add Portlets 



Add Portlets To Region 

Drill down to the appropriate provider, then click the portlet name to add the portlet to this region. 



General 



OWBBLQNDON2 - 
Warehouse Builder 

Browser <^ 

The Launcher portlet for the 
Oracle Warehouse Builder 

Browser application 

Warehouse Builder i 
jRe goirtd 

The Reports portlet for the 
Oracle Warehouse Builder 

Browser application 

OWBBLQNPON2 - 
Warehouse Builder 
Administration Z\ 

The Administrator portlet for the 
Oracle Warehouse Builder 

Browser application 



OWBBLONDON2 - 
Warehouse Builder 
Navigator 

The Navigation Portlet for the 
Oracle Warehouse Builder 

Browser application 

OWBBLQNPON2 - 
Warehouse Builder 
Favorites 

The Favorites portlet for the 
Oracle Warehouse Builder 

Browser application 



Portlet Repository : Other Providers : OWBBLONDON2 
Warehouse Builder Provider 



OWBBLONDON2 - Warehouse Builder B| 
OWBBLONDON2 - Warehouse Builder N 
OWBBLONDON2-WarehouseBuilderR 



® 



® 



® 



® 



Text description of the illustration addport.gif 

3. Select the portlets to add to the Oracle Portal home page. 

The portlets you have added display in the right column. You can organize them by using the 
arrow buttons and delete them by using the X button. 

4. Click OK when you are done. 

The Edit Page displays the Warehouse Builder portlets that you added. 



Figure 17-6 Edit Page 
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^MainV i^Style U 



■*5 Portlets 



Edit Page: Warehouse Builder Development 




'lose 

•r., :■■:■<.- ' 



Modify the Contents of the Page 

Add portlets to a region, or remove or edit existing portlets. You can also add, 
delete, or edit regions and tabs, and edit the page banner. 



Actions: Hide Show I Delete Move 



Banner 



Edit Defaults 



D OWBB_904619 - Warehouse Builder Browser 
O OWBB_90461 9 - Warehouse Builder Reports 

□ OW8B.904819 - Warehouse Builder Administration 
CI 0WBBJ9O461 9 - Warehouse Builder Navigator 
fj OWBB 904619 - Warehouse Builder Favorites 



i 



□ 0WBB_9O461 9 - Warehouse Builder Navigator 



Text description of the illustration 14 8.gif 

Administering Warehouse Builder Browser 

The Warehouse Builder Administration pages can only be accessed by Oracle Portal users with full 
administrator privileges. 

From the Oracle Portal Home page, select the Administer Warehouse Builder Browser link to access the 
Warehouse Builder Administration pages. 



Figure 17-7 Administration Portlet in Warehouse Builder Browser 
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' 0WBBL0ND0N2 - Warehouse Builder Administration 


Help About 




Full Page 


newsier a warehouse builder Keposuorv 




Register Warehouse Builder repositories and maintain underlying database 
links. 




Renister a Custom Renort 




Add additional user defined reports to the supplied ones. 




Purae Stale User Information 




Remove information stored on obsolete users. 




Resource Management 




Manage access privileges to Warehouse Builder Browser resources. 




Manacje Preferences 




Save preferences to a file or load preferences from an existing 
Warehouse Builder Browser Schema. 




Manaae Dependency Index 




Choose how often to refresh the denendencv index for lineaae and imnact 
analysis diagrams. 





Text description of the illustration admn por.gif 



Figure 17-8 Launcher Portlet in Warehouse Builder Browser 



r Warehouse Builder Browser 


Help About 


Browse a Repository 




Select a role and click Browse. 




Role I QA User Ijg |BBBB| 




Browse Favorites 




Choose from a list of your Navigation and Report Favorites. 




Administer Warehouse Builder Browser 




Perform administrative functions such as registering repositories 


and granting 


access to users. 





Text description of the illustration laun poa.gif 

The Administration page contains links for the following administration actions: 
• Register a Warehouse Builder Repository 
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• Register a Custom Report 

• Resource Management 

• Managing Preferences 

• Managing the Dependency Index 

Register a Warehouse Builder Repository 

Before you can access repository metadata reports, register the Warehouse Builder repository with the 
Warehouse Builder Browser. 

To register a Warehouse Builder Design Repository: 

1 . Click Register an OWB Repository on the Warehouse Builder Administration home page. The 
Register Repository page displays. 

Figure 17-9 Register Repository Page 




Administer Database Links 

Create, edit or drop database links to Warehouse Builder repositories. 



Warehouse Builder Repository Properties 

Enter or update the properties of a Warehouse Builder repository. 



Name 




Description 




Text description of the illustration 14 11 .gif 

2. Specify the Warehouse Builder repository properties. Table 17-1 lists the properties. 



Table 17-1 Warehouse Builder Repository Properties 



Field 



Description 



Name 



The user-defined name to identify the repository in the browser system. This name 
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Field 



Description 



is displayed in the navigation pages. 



Database 
Link 



The name of the database link used to access the repository. The link must already 
be created using the Administer Database Links page. This field must be specified 
even if the repository is in the same database as the browser system. 



Description 



The user-defined descriptive text. This appears in the navigation pages for the 
repository. 



3. Click Apply to register the repository. 

4. Click OK. 

The repository displays in the Warehouse Builder Administration home page. 
Managing Repositories 

The Resource Management page lists all registered repositories. The actions listed next to the repository 
are described in Table 17-2 . 

Table 17-2 Repository Management 
Actions Description 



Unregister Use this to unregister the repository. After unregistering the repository, it can no longer be 
browsed using the Browser system. You must re-register the repository if you want to 
browse it again. 



Creating Database Links 

Use the Administer Database Links page to connect to Warehouse Builder repositories from the 
Browser. 

Figure 17-10 Administer Database Links Page 
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Access 



Use this to grant or revoke repository access privileges to the users. 



Edit 



Use this to edit repository properties. 
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Administer Database Links 




Create Database Link 

Existing Database Links 

A database link with an invalid status indicates either the database link is not functioning or the schema it 
points to is not a Warehouse Builder repository schema 




MYREPQSITQRY.US.ORACLE.COM 9.0.4 



OWBB_904619 Valid 12-DEC-02 edit drop 



Text description of the illustration 14 13.gif 
To create a database link: 

1 . Click Register an OWB Repository on the Warehouse Builder Administration home page. The 
Register Repository page displays. 

2. Click the link for Administer Database Links. 

3. Select Create Database Link from the Administer Database Links page. 
Figure 17-11 Create Database Links Page 



Create Database Link 










ok, 







Database Link Name | 
Warehouse Builder Repository User Name f 
Warehouse Builder Repository Password f 



Remote Database information 

Specify the host address, service name, protocol and host port number. 



Host Address 
Host Service Name 



Host Protocol IjCP^J 



Host Port Number 1521 
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4. Specify the database link name. 

5. Specify the Warehouse Builder Design repository user name and password. 

6. Specify the remote database information. 

Provide the host address, service name, protocol, and host port number. 

7. Click Apply to connect the link. 

8. Click OK. 

The new link displays on the Administer Database Links page. 
Viewing a Database Link 

To view a database link: 

1 . Select the name of the database link from the Administer Database Links page. 

The View Database Link page displays with a detailed report on the database link you selected. 

2. Click OK. 

The browser returns to the Administer Database Links page. 
Editing a Database Link 
To edit a database link: 

1 . From the Administer Database Links page, select edit for the database link you want to alter. The 
edit link is located under the Actions column. 

The Edit Database Link page displays. 
Figure 17-12 Edit Database Link Page 
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,pp[y 1 fQK| . Cancel, 



Database Link Name 



MYKEPOSITORY.XJS. ORACLE COM 



Warehouse Builder Repository User Name |QWB CALAIS! 8 
Warehouse Builder Repository Password 1™™°™ 



Remote Database Information 

Enter a remote database alias OR enter the parameters that are necessary for connecting to the remote 
database in the form of: 

(DESCRIPTION = (ADDRESS = (PROTOCOL^ <protocol>) (Host= <hostname>) (Port= <portno>)) 
(CONNECT_DATA = (SERVICE_NAME = <remote Database service name>))) 



(DESCRIPTION = ( ADDRESS_LIST = ( ADDRESS = ( PROTOCOL = m 
TCP ) ( HOST = 130.35.50.1 ) ( PORT = 1521 ) ) ) ( ff| 
CONNECT DATA = ( service name = ags . us . oracle . com ) ) ) V;; 



Text description of the illustration 14 15.gif 

2. Edit the database link and click Apply. 

3. Click OK. 

Dropping a Database Link 

Dropping a database link deletes it permanently. You must create a new link to use it again. 
To drop a database link: 

1 . If the database link has been used to register Warehouse Builder repositories, unregister the 
Warehouse Builder repositories. 

2. From the Administer Database Links page, select drop for the database link you want to drop. The 
drop link is under the Actions column. 

The database link is dropped and the browser returns to the Administer Database Links page. 
Unregistering a Repository 
To unregister a Repository: 
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L Select the Administer Warehouse Builder Browser link from the Browser page. 

2. Select Manage Resources. 

The Warehouse Builder Administration page displays as shown in Figure 17-13 . The table at the 
bottom of the page lists the registered repositories listed. 

Figure 17-13 Registered Repositories and Roles 



Resource 



Launcher Portlet 
Apps 

Warehouse Builder 
QAUser 

Warehouse Engineer 
Warehouse User 



Portlet 

Repository 

Repository 

Role 

Role 

Role 



Actions 



access 

access edit unregister 

access edit unregister 

access 

access 

access 



Text description of the illustration unreg.gif 

3. Select the repository to unregister and click on the unregister link. 

The repository is unregistered and no longer appears in the list of registered repositories. You can 
no longer browse it using the Browser. 

Register a Custom Report 

A custom report is an application component created in a tool such as the Oracle Portal facilities. 
Registration of the report provides the browser system with the information required to invoke the 
report. For more information, see "Creating Custom Reports" . 

To register a custom report: 

1 . From the launcher portlet, click the Administer Warehouse Builder Browser link, and then 
select the Register a Custom Report link. 

The Register a Custom Report page displays. 



Figure 17-14 Register Custom Report Page 
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2. Enter a display name for the report. 

3. Select the type and repository from the drop-down lists. Table 17-3 lists the custom report 
properties. 

Table 17-3 Custom Report Properties 



Field 



Description 



Display Name Name of the report. This name is displayed on the Reports List page. 

Type Name Name of the data type reported on by this report. 

Package The full name of the PL/SQL package which implements this report. 
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Field 



Description 



Repository 



Name of the repository containing target objects for this report. 



4. Enter the qualified package name for the report in the format <schema> . <package>. The package 
name is displayed on the Develop page for the report. 

5. Click Apply or OK to complete the registration. 

The report appears in the resource list of the administration page. 

Adding a Custom Report to a Role 

To add a custom report to a Warehouse Builder Browser role: 

1 . Click the roles action link from the resource list entry for the custom report. 

2. Click the add action link for each role that you want to access the report. 

Resource Management 

Resource Management allows you to access rights to many aspects of the Warehouse Builder Browser as 
well as editing, registering, and unregistering repositories and reports. 

The Resource Management page contains a table listing all resources that have been registered in the 
Warehouse Builder Browser. The following sections describe how to modify these resources. 

Figure 17-15 Resource Management 
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Adding User Accounts 

To add a user account for Warehouse Builder Browser: 

1 . From the Resource Management page, select the Access action listed next to the resource entitled 
Launcher Portlet, as listed first in Figure 17-15 . 

Warehouse Builder Browser displays the Portlet Access page. 
Figure 17-16 Portlet Access 
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From the Portlet Access page, you can perform the following tasks: 

• Grant an access right to a Single Sign On user by selecting the name of the user from the 
drop-down list and clicking Grant User. 

• Grant an access right to an Oracle Portal group by selecting the name of the group from the 
drop-down list and clicking Grant Group. 

• Revoke an access right by clicking revoke in the appropriate table row. 

To use the Warehouse Builder Browser, your single sign on user or a group associated with that user 
must have rights to one of these Warehouse Builder pre-defined roles: 

3 • Warehouse Developer: A user who uses Warehouse Builder to create the warehouse. 

• QA User: A user who tests the quality of the warehouse before it is deployed. 

• Warehouse User: A user who uses the deployed warehouse to understand the underlying 
metadata. 

The Administrator can assign these roles to users and groups. All of the pre-defined Reports and 
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Navigation pages are available to all roles. When you add custom reports, you can assign them to 
different roles. 

For the QA User role, objects that fail validation display an error icon in the Contents tab of the 
Navigation page. This error icon is not displayed in reports for the other roles. 

Figure 17-17 Validation Error 
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Managing Custom Reports 

The Resource Management page lists all registered custom reports. The actions listed next to the 
repository are described in Table 17-4 . 

Table 17-4 Custom Report Management 
Actions Description 

Role Use this to assign a report to one or more roles. When the report is assigned to a role, it 
appears in the appropriate report list for that role. 



Edit 



Use this to edit custom report properties. 
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Actions Description 



Unregister Use this to unregister the report. After unregistering the report, it can no longer be browsed 
using the browser system. 



Assigning a custom report to a role adds the report to the appropriate report list page for that role. The 
name and subject type of the report are indicated at the top left corner of the page. A list of the available 
roles is provided in the table at the bottom of the page. 



Managing Preferences 

Use the Manage Preferences page to save and load Warehouse Builder Browser preferences. This lets 
you retain your preferences when you upgrade to a new version of Warehouse Builder Browser. You can 
copy schema preferences across schemas. ' 

The preferences you can save include: 

• Favorites. 

• Registered custom reports. 

• Registered Warehouse Builder Repositories. 

^ • Access rights associated with roles, repositories, custom reports, and the Launcher Portlet. 

• External Links. 



Figure 17-18 Manage Preferences Page 
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Displays an import file containing all Warehouse Builder Browser preferences. 
Use your web browser save function to save it as a file. 



Load Preferences 

Copies preferences from one Warehouse Builder Browser, to this Warehouse 
Builder Browser. 7. 



Text description of the illustration mng pref.gif 
Saving Preferences 
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To save preferences to a file: 

1 . Select Save Preferences from the Manage Preferences page. 
The preferences display in a separate window in text format 

2. From the browser menu bar, select File, and then Save As to save the file. 

This file can be loaded into Warehouse Builder Browser using a tool such as SQL* Plus. 

Loading Preferences 

To load preferences from an existing schema: 

1 . Select Load Preferences from the Manage Preferences page. 

Figure 17-19 Load Preferences Page 
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Text description of the illustration load pre.gif 

2. Specify the following information from an existing Warehouse Builder Browser schema: 

• Schema Name 

• Schema Password 
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• Hostname 

• Host Port Number 

• Host Service Name 

3. Click OK to load the preferences into the current Warehouse Builder schema. 

A status page displays the preferences that were loaded and any errors that occurred. All errors 
must be resolved to load the preferences. Errors due to missing database links provide links to the 
Create Database Links page. 



Note: 

Database links are not automatically created. If the preferences you are loading 
contain references to repositories, the database links to those repositories must 
be created before the load can be successful. 



Managing the Dependency Index 

Use the Manage Dependency Index page to specify the refresh frequency options for the 
dependency index for each repository. The dependency index is used to increase performance 
when running lineage and impact analysis diagrams. You can refresh the dependency index at any 
time from the Repository page of the Warehouse Builder Navigator. 

Setting the Refresh Options 

To specify the dependency refresh option: 

1 . Open the Warehouse Builder Browser, and select Manage Dependency Index from the 
Administration page or portlet. 

The Manage Dependency Index page displays the available repositories and refresh options. 
Figure 17-20 Setting Refresh Options 
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2. Choose one of the options from the drop-down list and click OK. Table 17-5 describes each 
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option. 



Table 17-5 Dependency Index Options 



Option 



Description 



Refresh on You must activate the refresh dependency index link to refresh the 

demand index. This link is located on Navigator page that lists all accessible 

repositories. The dependency index is only refreshed when this action 

link is activated. 

This is the best option when using a repository that changes 
infrequently. 



Refresh on first Refreshes the dependency index when the first Lineage or Impact 
diagram request of Analysis diagram for a repository is run during a session, 
the session 

This is the best option if you want current information, but are not 
concerned with repository updates that occur during the session. 



Refresh on every Refreshes the dependency index every time a Lineage or Impact 
diagram request Analysis diagram is requested. 

This is the best option if you want to display your diagrams and reports 
with the latest information in the repository. 



Refreshing the Dependency Index on Demand 

You can refresh the dependency index at any time. If you run a Lineage or Impact Analysis 
diagram that has never been refreshed, an automatic refresh occurs prior to displaying the diagram. 

To refresh the dependency index: 

1. Open the Warehouse Builder Browser from the Launcher portlet. 

The Contents tab that displays lists the available repositories. 
Figure 17-21 Refreshing the Dependency Index 
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2. Select refresh dependency index. 

The Refresh Dependency Index page displays with a log of previous refreshes at the bottom 
of the page. The elapsed time helps you determine how long the operation will take. 

Figure 17-22 Dependency Index Refresh Log 
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3. Select Refresh Dependency Index to refresh the dependency index based on the latest data 
in the repository. 

After the refresh is complete, the log displays the user name, date, and elapsed time of the 
refresh. You can purge the log by selecting Purge Log. This purges the log of the refreshes 
except for the last refresh. 
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Other Administration Tasks 



To refresh the Portlet Repository: 

1 . From the Oracle Portal Home Page, click the Administer tab. 



2. Scroll down to locate the Portlet named Portlet Repository. 



3. Click Refresh Portlet Repository. 



4. Click Refresh. 



Configuring the Warehouse Builder Client 

The Warehouse Builder Console includes a Preferences dialog containing tabs that you use to 
configure the Warehouse Builder environment. Use the Browser tab to set the network and IP 
connection information for Oracle Portal. This enables you to view metadata reports using the 
Warehouse Builder Browser. 



To access the preferences dialog: 

1. From the Project menu, click Preferences. 



Figure 17-23 Selecting Preferences from the Project Menu 
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Text description of the illustration preferen.gif 

2. From the Preferences dialog, select the Browser tab. 

Figure 17-24 Browser Tab 




Text description of the illustration 14 21 .gif 

3. Specify the following information: 

• Oracle Portal Host Name 

• Oracle Portal Port Number 

• Oracle Portal DAD 

• Warehouse Builder Browser Schema Name 

4. Click OK. 
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Creating Custom Reports 

You can create custom reports on your metadata using the Warehouse Builder Public Views and 
Standard Query Language (SQL). These views provide access to your metadata repository tables 
and report on your data definitions, transformations, and deployment areas. You can use the 
Warehouse Builder Browser or another reporting tool to view the public views. 

For a complete list of available Public Views and the objects they contain, see Appendix D, 
"Warehouse Builder Public Views" . 

Creating a Custom Report in Oracle Portal 

To create a custom report using Oracle Portal: 

1 . Log on to Oracle Portal and select the Database Objects tab from the Navigator page. 

2. Find the schema where the Warehouse Builder Browser is loaded, and edit the schema 
details to ensure that the Application Schema check box is selected. 

3. Select the Applications tab, and click the Create New Application link. 

4. Create a new application and click OK. 

5. Select the application you just created and select the Create New Report link. 

6. Select the Report from SQL Query link from the page that displays next. 

7. Type the report name and display name and click Next. 

8. Type the SQL query to define the report and click Finish. 

Click Next to continue to pages where you can customize the appearance of the report. To 
customize the report at a later time, select the Edit action. 

Your SQL queries must reference a database link to the Warehouse Builder repository. You can 
use the default_owbJink created during the Warehouse Builder Browser installation. The SQL 
query for a report can only call PUBLIC database link or links within the application schema 
where a report resides. 

Although a reports can reside in a schema other than Warehouse Builder Browser schema, the 
report must be executable by the Warehouse Builder Browser schema. To grant execution 
privilege for a portal report, go to Oracle Portal Home Page > Database Objects > Database 
Schemas > Report Schema > Report Package > Grant Access. 

The following query provides a simple project report that lists the information systems it contains: 

select * from all_iv_inf ormation_systems@def ault_owb_link where projected - : id 

When run from the Warehouse Builder Browser Navigation pages, the marker :id is automatically 
substituted with the appropriate value. 
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Verify that the report can be run in the following environments: 

• SQL*Plus: Log on as the user who owns the report. The owner is displayed on the Develop 
page for the report. In SQL* Plus, replace the marker :id with a valid projected. 

• Oracle Portal: From the Develop page, select the Customize link, enter a valid projected 
in the edit box labelled Id, and click Run Report. 
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18 

Extending Warehouse Builder Functionality 

This chapter describes how to extend current Warehouse Builder functionality. This chapter includes the 
following topics: 

• About Oracle Metabase (OMB) Plus 

• User-Defined Properties 

• Managing Security with PL/SQL 

About Oracle Metabase (OMB) Plus 

This chapter discusses tasks you can perform to extend Warehouse Builder functionality via Oracle 
Metabase (OMB) Plus. 

OMB Plus is the flexible, high-level command line metadata access tool for Oracle9i Warehouse 
Builder. With OMB Plus, you can write the syntactic constructs such as variable support, conditional and 
looping control structures, error handling, and standard library procedures. You can access the 
Warehouse Builder metadata repository and the runtime repository. Using OMB Plus, you can navigate 
repositories and manage and manipulate metadata in repositories. 

The remainder of this chapter discusses how to perform specialized tasks in Warehouse Builder using 
the OMB scripting language. For syntax information on specific OMB Plus commands, see Oracle9i 
Warehouse Builder Scripting Reference, 

User-Defined Properties 

Warehouse Builder allows you to extend its design repository through User Defined Properties (UDP). 
Each repository object has a pre-defined property set. You can add custom properties to an object by 
creating a UDP. 

A You create and manage UDPs using the Oracle MetaBase (OMB) Scripting Language. You can view 
/ UDPs using OMB or the Warehouse Builder client. In the client, UDPs display on property sheets and in 
the Warehouse Builder Browser. 
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UDPs behave like native properties and follow Warehouse Builder rules for object locking, multiuser 
access, transactions, and security. When you take metadata snapshots of the object, Warehouse Builder 
captures the associated UDPs. You can also import and export UDPs using the Metadata Loader (MDL). 

Managing User Defined Properties 

As the Warehouse Builder administrator, you should define all user-defined properties into the 
Warehouse Builder repository before allowing end users to access it. In doing so, you avoid the task of 
supplying values for UDPs on existing objects. 

You should register all user-defined properties centrally in the design repository, and not locally on the 
client. To create or edit a UDP, you must be the single user accessing to the Warehouse Builder 
repository. 

You can use the following OMB Plus commands for creating and manipulating user defined properties: 

• OMBDEFINE 

• OMBDESCRIBE 

When you create and commit a UDP, OMB performs the following validations: 

• A namespace check ensures that you did not define two identically named properties within the 
same class hierarchy. Prefix the user defined property with 'UDPJ to avoid conflicts with the 
future names introduced by Warehouse Builder. 

• A property value check ensures that you defined default values consistent with the data types you 
specified. 

• A user access check ensures that you have single-user access to the entire repository. 
OMBDEFINE 

The OMBREDEFINE CLASS_DEFINITION allows you to manipulate UDPs. To create a UDP on the 
Dimension object, issue the following statement. This adds a UDP definition to class definition 
'DIMENSION': 

OMBREDEFINE CLASS_DEFINITION 'DIMENSION' 

ADD PROPERTY_DEFINITION 'UDPJDim' SET PROPERTIES (TYPE, DEFAULT_VALUE ) 
VALUES ('INTEGER 1 , '100') 

The following command adds a property to the 'COLUMN' type. This property displays in the Table, 
View, Materialized View, External Table and Sequence Property Sheets: 

OMBREDEFINE CLASS_DEFINITION ' COLUMN ' 

ADD PROPERTYJDEFINITION 'UDP_Col' SET PROPERTIES (TYPE, DEFAULT_VALUE ) 
VALUES ( 1 STRING ' , ' f oo ' ) 

The following command allows you to change the name or the default value of a given property. 

OMBREDEFINE CLASS DEFINITION 'TABLE' MODIFY PROPERTY DEFINITION 'UDP Tbl ' 
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SET PROPERTIES ( DEFAULT_VALUE, BUSINESS__NAME) 
VALUES ( , 99 , / f UDP_Tbl f ) 

The following command deletes the tbl_udp property from the Table 1 class. This is a very destructive 
and highly deprecated action since it cannot be undone. It renders all property value customizations 
made for this property definition in your repository irretrievable: 

OMBREDEFINE CLASS_DEFINITION 1 TABLE 1 DELETE PROPERTY_DEFINITION 'UDPJTbl' 

OMBDESCRIBE 

You can use OMBDESCRIBE on a Class Definition to view the attributes for a metadata element. 
OMBDESCRIBE allows you to list the user defined properties you for a given object type. For instance, 
the following command lists the user defined properties for a dimension: 

OMBDESCRIBE CLASS ^DEFINITION 1 DIMENSION 1 GET PROPERTY_DEFINITIONS 

You can also use OMBDESCRIBE to introspect the properties of a Property Definition. For instance, for 
a user defined property called UDP_Dim under the Dimension Class Definition, you can learn the 
datatype, default value and business name with the following command: 

OMBDESCRIBE CLASS_DEFINITION 1 DIMENSION 1 PROPERTY_DEFINITION 'UDPJDim' 
GET PROPERTIES (TYPE, DEFAULT_VALUE, BUSINESS_NAME ) 

You can specify the data type of a user-defined property such as char, number and date. 

Viewing User Defined Properties 

In the user interface, you can view UDPs in the following components: 

• Warehouse Builder Client 

• Warehouse Builder Design Browser 

Warehouse Builder Client 

Once you create a UDP using scripting, Warehouse Builder displays the UDP in the User Defined 
Properties tab on the associated properties sheet. The User Defined Properties tab does not appear until 
you create a UDP. For example, the Dimension Properties sheet typically does not display the User 
Defined Properties tab. However, once you add a UDP to a dimension, the UDP appears on the 
Dimension Properties sheet shown in Figure 18-1 . 

Figure 18-1 Sample Properties Sheet with User-Defined Properties 
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Text description of the illustration samplepr.gif 

In the left panel, the tab displays the object navigation tree. In the right panel, the tab lists all the 
contained objects and corresponding extended properties. It shows the values and categories you 
specified when you created the UDP in scripting. You can modify the values but not the categories in the 
User Defined Properties tab. You must use OMB Plus to edit categories. 

Warehouse Builder Design Browser 



The Warehouse Builder Browser also displays UDPs. Warehouse Builder Browser is a metadata 
management and reporting portal for Warehouse Builder. Browser displays object properties, object 
relationships, and lineage and impact analysis reports. 

If you define a UDP for a given object, the Browser lists the UDP name and values as Extended Property 
Name and Extended Property Value as shown in Figure 18-2 . 

Figure 18-2 Sample Properties Sheet with User-Defined Properties 
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Transferring UPDs to Other Repositories 

The primary method for propagating changes from one repository to another is via MDL. The MDL 
allows you to export and import the metadata definition of the user-defined properties and its contents. 

Exporting UDPs 

You can export UDPs from the command line only. In the MDL Control file, the option is 
DEFiNiTiONFiLE=f iiename to export the metadata definition. For example: 

## Sample Export file 

USERID==UserName/Password@HostName : Port ID : OracleServiceName 
# 

DEFINITIONFILE=Drive : \ Di recto ryName\f iiename .mdd 

FILE=Drive : \DirectoryName\f iiename .mdl 
LOG=Drive : \DirectoryName\f iiename . log 



Importing UDPs 

You can import UDPs from the command line only. During import, MDL updates the user-defined 
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properties for all objects.In the MDL Control file, the option is DEFINITIONFILE=filename to import 
the metadata definition. For example: 

## Sample Import file 

USERID=UserName/Password@HostName : PortID: OracleServiceName 
# 

DEFINITIONFILE=Drive : \DirectoryName\ filename .mdd 

FILE=Drive : \DirectoryName\f ilename .mdl 
LOG=Drive : \DirectoryName\f ilename . log 

You can import UDPs using one of the following search criteria: 

• Universal ID: The metadata definition contains a Universal Object ID (UOID). The UOID 
uniquely identifies objects across repositories. If you import the MDL file by UOID, then MDL 
looks up the metadata definition by UOID. If the metadata definition name in the source MDL file 
is different from the metadata definition in the repository, then MDL renames it. 

• Physical Name: MDL looks up the metadata definition by physical name. 

Regardless of the import mode, MDL either adds the metadata definition if it does not exist in the 
repository, or updates the metadata definition if it already exists. MDL will not delete metadata 
definitions in the repository. 

When updating the metadata definition, MDL only renames the object if the names are different (search 
criteria is by UOID), and update the default value. MDL does not change the datatype (e.g., STRING). 

Managing Security with PL/SQL 

This section contains the following topics: 

• Maintaining Repository Users 

• Plug-in Interface for the Security PL/SQL Package Specification 

• Definitions of the Constants in the Package Specification 

• Implementing the PL/SQL Interface 

Maintaining Repository Users 

Multiple identifiable Warehouse Builder users can access the same central repository schema when they 
3j are registered by the repository owner. 

Warehouse Builder includes utility procedures for the following maintenance tasks: 

• Update the role protecting password 

Although the repository owner does not explicitly use the protecting password for the role, it is 
recommended that the repository owner change the password often. 
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The repository owner must connect to the repository schema using SQL Plus and issue the 
following statement: 

Call WBSecurityHelper . updateRolePwd ( 1 newpwd' ) ; 

where ' newpwd' is the new password used to protect the role chosen by repository owner. The 
changed password encryption appears in the table called OWBjrole_info table. 

• Register repository users 



To register a repository user, execute the following statement in SQL Plus: 

call WBSecurityHelper . registerOWBUser ( ■ username 1 ) 

• Unregister repository users 

To unregister a user from a repository, execute the following statement in SQL Plus: 

Call WBSecurityHelper . unregisterOWBUser ( 1 username ' ) / 

• List all repository users 

The repository owner must connect to the database containing the repository and issue the 
following statement: 

Set serveroutput on; 

Call WBSecurityHelper . listOWBUser ( ); 

Set serveroutput on is required since listOWBUser ( ) uses the DBMS__OUTPUT.put_line for 

the output to dump the data to the user interface. Otherwise, dbmsjdutput .put_iine only dumps 
the output into an intermediate data structure. 

Plug-in Interface for the Security PL/SQL Package Specification 

This section describes the plug in interface specification for the PL/SQL security package provided by 
Warehouse Builder. You need to substitute the dummy PL/SQL package body provided by Warehouse 
Builder by implementing this interface in your Warehouse Builder repository. The interface specification 
and the dummy implementation are also available from your repository schema. 

CREATE OR REPLACE PACKAGE WBSecurityServicelmpl AS 
FUNCTION isSecurityServiceCustomized RETURN NUMBER; 



Use Function: isSecurityServiceCustomized() to differentiate the implementation of security service, 
whether you customize the security PL/SQL implementation or use the implementation provided by 
Warehouse Builder. 

Return value: this function returns 1 if you want to implement the PL/SQL package of this specification, 
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otherwise it returns 0; 

*/ 

PROCEDURE securityCheckForCreation (outcome OUT NUMBER, 
user Id IN VARCHAR2 , 

objectUOIDOperationlnvokedOn IN VARCHAR2, 
status IN VARCHAR2, 
parentModuleUOID IN VARCHAR2 , 
parentProjUOID IN VARCHAR2 , 
repos_Schema IN VARCHAR2 , 
objectType IN NUMBER); 

/* 

Procedure: securityCheckForCreation: Used to create an operation security check. When you try to 
create an object, Warehouse Builder calls this procedure to ask the implementation whether the creation 
operation is acceptable or not. 

Argument explanation: 

Outcome: 1: The creation operation is acceptable. 
Outcome: 0: The creation operation is not acceptable, 
userld: The login user's database user name. 

objectUOIDOperationlnvokedOn: The parent folder UOID, where you create a new object. For 
objects, such as Projects and Snapshots, that do not have folder parent, this argument is NULL. 

status: An attribute of a module: WB_DEV_STATUS, WB_QA_STATUS, WB_PROD_STATUS 
defined in this specification. This attribute describes the status of the module. For objects, such as 
Projects, Modules, or Snapshots, that are not children of any module in the hierarchy, this argument is 
NULL. 

parentModuleUOID: The UOID of the module. For objects such as Projects or Snapshots that are not 
children of any module in the hierarchy, this argument is NULL. 

parentProjUOID: The UOID of the project. For objects such as Projects or Snapshots that are not 
children of any module in the hierarchy, this argument is NULL. 

reposjschema: The central repository schema name you are working on. 

objectType: The type of object you want to create. It is one of the object type constants defined in this 
specification. 

*/ 

PROCEDURE securityCheck (outcome OUT NUMBER, 
userld IN VARCHAR2, 
operation IN NUMBER, 

objectUOIDOperationlnvokedOn IN VARCHAR2 , 
objectTypeOperationlnvokedOn IN NUMBER, 
status IN VARCHAR2 , 
parentModuleUOID IN VARCHAR2 , 
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parentProjUOID IN VARCHAR2 , 
repos_Schema IN VARCHAR2 ) ; 

/* 

PROCEDURE: securityCheck is used for the following operations: 

WB_EDIT 

WB_DELETE 

WB_VALIDATE 

WB_GENERATION 

WB_VERSION 

Whenever you invoke one of the above listed operations, Warehouse Builder calls this procedure to see 
whether the operation is acceptable or not. 

Argument explanation: 

Outcome: 1: The creation operation is acceptable. 
Outcome: 0: The creation operation is not acceptable, 
userld: The login user's database user name, 
operation: One of constants listed above. 
objectUOIDOperationlnvokedOn: The target object's UOID. 

objectTypeOperationlnvokedOn: The type of object the operation is invoked on (one of the object 
type constants defined in this specification). 

status: An attribute of a module. 

WB_DEV_STATUS 

WB_QA_STATUS, 

WB_PROD_STATUS 

This attribute is used to describe the status of the module. If you operate on a project, module, or 
snapshot, this argument is NULL. 

parentModuleUOID: The UOID of the module. If you invoke the operation on a module, then the 
objectUOIDOperationlnvokedOn and the parentModuleUOID are the same. If you invoke an operation 
on a project or snapshot that is not a child of any module in the hierarchy, this argument is NULL. 

parentProjUOID: The UOID of the project. If you invoke the operation on a project, then the 
objectUOIDOperationlnvokedOn and the parentProjUOID are the same. If you invoke the operation on a 
snapshot that is not the child of any project in the hierarchy, this argument is NULL. 

repos_schema: The central repository schema name you are working on 

*/ 
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PROCEDURE securityCheckForServi.ee (outcome OUT NUMBER, 
userld IN VARCHAR2, 
serviceOp IN NUMBER, 
moduleUOID IN VARCHAR2, 
projUOID IN VARCHAR2 , 
repos_Schema IN VARCHAR2); 



/* 

PROCEDURE securityCheckForService is used for the following service operations: 

WBDEPLOY 

WBMDLIMPORT 

WBMDLEXPORT 

WBBRIDGEIMPORT 

WBBRIDGEEXPORT 

WB_SOURCE_IMPORT 

WBRUNTIMEEXECUTE 

WBSNAPSHOTRESTORE 

Argument explanation: 

Outcome: 1: The creation operation is acceptable. 
Outcome: 0: The creation operation is not acceptable, 
userld: The login user's database user name. 
serviceOp: One of constants listed above. 

moduleUOID: The UOID of a module on which the user is invoking operatiomserviceOp. The result is 
NULL for serviceOp:WB_DEPLOY,WB_BRIDGE_EXPORT, WB_RUNTIME_EXECUTE. It is valid 
for: WB MDL IMPORT, WB MDL EXPORT, WB_SOURCE_IMPORT, 
WBSN AP SHOTRESTORE . 

projUOID: The UOID of a project on which the user is invoking the operation: serviceOp on it. The 
result is NULL for the serviceOp: WB_DEPLOY, WB BRIDGE EXPORT, 
WB_RUNTIME_EXECUTE. It is valid for: WB_MDL_IMPORT, WB_MDL_EXPORT, 
WB_SOURCE_IMPORT, WB SNAPSHOT RESTORE. 

repos_schema: The central repository schema name you are working on 

*/ 

--BEGIN CONSTANT DEFINITION 
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CU S TOM_S HARE D_JLI BRAR Y CONSTANT 

VARCHAR2 (100) : - 1 9E012195D1 6211D48D7100B0D02A59E8 1 ; 
/* 

CUSTOM_SHARED_LIBRARY: The UOID constant for a predefined Warehouse Builder folder: 
Custom shared library. On the UI, this folder is called Custom located under the Public Transformation 
node. 

This folder contains all global shared library transformations created by the user. 

To control the users who have permission to create transformations under the Custom folder, you can 
check if the argument objectUOIDOperationlnvokedOn in procedure securityCheckForCreation equals 
to this constant or not. To control users who can invoke the operations such as WB_EDIT or 
WBDELETE, on a shared function or a procedure, check if the argument parentModuleUOID in the 
^ procedure securityCheck equals this constant or not. 

Since this module is predefined, you cannot change the status or use the status of this module for access 
control. 

*/ 

—Definition of constants for all basic operations 

WB__EDIT CONSTANT INTEGER := 0; 
WBJ3ELETE CONSTANT INTEGER := 1; 
WB_REFERENCE CONSTANT INTEGER := 2; 
WB_CREATE CONSTANT INTEGER := 3; 

WB_VALIDATE CONSTANT INTEGER := 4; 
WB_GENERATION CONSTANT INTEGER := 5; 
WB_VERSI0N CONSTANT INTEGER := 6; 

/* 

Use this group of operation constants in the SecurityCheck procedure. Use one of the above constants 
( for the argument "operation". You can also use it to control which user can invoke this operation. 

*/ 

—Definition of constants for all service type operations 

WBJDEPLOY CONSTANT INTEGER := 100; 
WB_MDL_IMPORT CONSTANT INTEGER := 101; 
WB_MDL_EXPORT CONSTANT INTEGER := 102; 
WB__BRI DGE_IMPORT CONSTANT INTEGER := 103; 
WB_BRIDGE_EXPORT CONSTANT INTEGER := 104; 
WB_SOURCE_IMPORT CONSTANT INTEGER := 105; 
WB_RUNTIME_EXECUTE CONSTANT INTEGER :=106; 
WB_SNAPSHOT_RESTORE CONSTANT INTEGER := 107; 

/* 

Use this group of service operation constants in SecurityCheckForService procedure. Use one of these 
[ constants for the argument "serviceOp". You can also use it to control which user can invoke this service 
operation. 
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*/ 



-Definition of the module status 

WB_DEV_STATUS CONSTANT VARCHAR2 ( 100 ) : = 1 DEV_STATUS ' ; 
WB_QA_STATUS CONSTANT VARCHAR2 ( 100 ) := ' QA__STATUS ' ; 
WB_PROD_STATUS CONSTANT VARCHAR2 ( 100 ) := 1 PROD_STATUS ' ; 

/* 

Use this group of module status constants should be used in the securityCheckForCreation and 
SecurityCheck procedures. Use the above constants if you want to create a child of a module (for 
securityCheckForCreation) or if you invoke an operation on a module or the child of a module (for 
SecurityCheck), otherwise the argument "status" will be null. You can also use it to implement your 
access control based on the status of the module. 

*/ 



—Definition of object type 

WB_PROJECT CONSTANT INTEGER := 1; 
WB_0RACLE__M0DULE CONSTANT INTEGER := 2; 
WB_GATEWAY_M0DULE CONSTANT INTEGER := 3; 
WB_SAP_MODULE CONSTANT INTEGER := 4; 
WB_FLAT_FILE_MODULE CONSTANT INTEGER := 5; 
WB_SHARED_MODULE CONSTANT INTEGER := 6; 
WB_REP0S_M0DULE CONSTANT INTEGER := 7; 
WB_C0LLECTION CONSTANT INTEGER := 8; 
WB_WAREHOUSE CONSTANT INTEGER := 9; 
WBJTABLE CONSTANT INTEGER := 10; 
WB_VIEW CONSTANT INTEGER := 11; 
WB_MATERIALIZED_VIEW CONSTANT INTEGER := 12; 
WB_SEQUENCE CONSTANT INTEGER := 13; 
WB_DIMENSION_TABLE CONSTANT INTEGER := 14; 
WB_CUBE_TABLE CONSTANT INTEGER := 15;. 
WB_FLAT_FILE CONSTANT INTEGER := 16; 
WB_PACKAGE CONSTANT INTEGER := 17; 
WB_TRANS FORMATION CONSTANT INTEGER := 18; 
WB_MAPPING CONSTANT INTEGER := 19; 
WB_MIV_MODULE CONSTANT INTEGER := 20; 
WB_CONNECTOR CONSTANT INTEGER := 21; 
WB_LOCATION CONSTANT INTEGER := 22; 
WB_RUNTIME_REPOSITORY CONSTANT INTEGER := 23; 
WB_BUSINESS_AREA CONSTANT INTEGER := 24; 
WB_INTELLIGENCE_MODULE CONSTANT INTEGER := 25; 
WB_PROCESS_FLOW CONSTANT INTEGER := 26; 
WB_PROCESS_FLOW_MODULE CONSTANT INTEGER := 27; 
WB_PROCESS_FLOW_PACKAGE CONSTANT INTEGER := 28; 
WB_QUERY_OBJECT CONSTANT INTEGER := 2 9; 
WB_ADVANCED_QUEUE CONSTANT INTEGER := 30; 
WB_EXTERNAL_TABLE CONSTANT INTEGER := 31; 
WB_REPORT CONSTANT INTEGER := 32; 
WB_REPORT_GROUP CONSTANT INTEGER := 33; 
WB_REPORT_MODULE CONSTANT INTEGER : = 34; 
WB_OBJECT_TYPE CONSTANT INTEGER := 35; 
WB_SNAPSHOT CONSTANT INTEGER := 36; 

/* 

This group of object type constants must be used in procedures securityCheckForCreation and 



12 of 18 



5/9/2007 2:13 PM 



Extending Warehouse Builder Functionality 



http://download-west.oraclexom/docs/html/B 10657_0 1/1 8extend.ht.. 



securityCheck. The argument "objectType" in securityCheckForCreation and argument 
"objectTypeOperationlnvokedOn" in securityCheck will be one of the above constants. You can use this 
constant to control which user can create which kind of object or which user can invoke operations such 
as WBEDIT or WBDELETE on what types of objects. 

*/ 

/* 

Because there are many arguments, the procedures will depend on whether the object on which the user 
invokes an operation is the child of the project or a module. The information is listed below. 

*/ 

—Children of Project 

/* 

While WB_SNAPSHOT and WB_PROJECT are not children of a project, other objects in the list of 
type constants are. 

*/ 

—Children of Module 

/* The following are not children of any module: WBJ>ROJECT, WBORACLEJVIODULE, 
WB J3ATEWAY_MODULE, WB_SAP_MODULE, WBJ 7 LATJFILE_MODULE, 
WBSHAREDMODULE, WB_REPOS_MODULE, WB_COLLECTION, WB_WAREHOUSE 5 
WB_MIV ^MODULE, WB ^LOCATION, WB_CONNECTOR, WB_RUNTIME_REPOSITORY, 
WB_BUSINESS_AREA, WBENfTELLIGENCEMODULE, WB_PROCESS_FLOW_MODULE, 
WBREPORTMODULE, WB_SNAPSHOT. 

Other object types can be the children of module. 

*/ 

END WBSecurityServicelmpl; 

Warning 

For the following procedure defined in the above specification: 

PROCEDURE securityCheckForService (outcome OUT NUMBER, 

userlD IN VARCHAR2, 
serviceOp IN NUMBER, 
moduleUOID IN VARCHAR2 
projUOID IN VARCHAR2 
repos_Schema IN VARCHAR2) ; 



For this release, do not use the arguments: moduleUOID and projUOID. In later releases Warehouse 
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Builder will provide module and project level security check for the following service operations: 
SNAPSHOT_RESTORE, SOURCEJMPORT, MDLJMPORT, MDLEXPORT, and 
BRIDGEIMPORT. 

Definitions of the Constants in the Package Specification 

The following section lists the constant definitions of basic operations. For these operations, Warehouse 
Builder checks if the operation is acceptable or not on an object instance level 

• wb_edit: Edit (update) operation 

• wb_delete: Delete operation 

• wb_reference: The operation you want to reference an object within another object. For example, 
when you want to drag a table into a mapping as an operation. 

• wb_create: Create operation 

• wb_validate: Validate operation used to check the accuracy of the object definitions 

• wb_generation: Generate the SQL scripts for the definitions in Warehouse Builder 

• wb_version: Versioning objects which means user can add an object to a snapshot version, 
remove an object from a snapshot version, or replace an existing versioned object with a new 
copy. 

The following section lists the constant definitions for service operations. For these operations, 
Warehouse Builder checks if the operation is acceptable or not on a system wide level. If a user has the 
privilege to invoke a service operation, he should invoke this operation on any object. For operations 
such as WB_MDL_IMPORT, WBMDLEXPORT, WB BRIDGE IMPORT, 
WB_SOURCE_IMPORT, WB SNAPSHOT RESTORE, Warehouse Builder provides security at the 
project or module level. 

• wb_deploy: First generates the SQL script (if does not exist) and then deploy the SQL scripts to a 
runtime database schema. 

• wb_mdl_import: Imports the metadata into Warehouse Builder from a flat file format. 

• wb_mdl_export: Exports the metadata from Warehouse Builder into a flat file. 

• wb_bridge_import: Another importing solution. 

• wb_bridge_export: Another exporting solution. 

• wb_source_import: Imports the metadata information of database objects, such as tables and 
views, into Warehouse Builder from a given database link. 

• wb_runtime_execute: Executes the deployed SQL script from the runtime database schema. 

• wb_snapshot_re store: Restores the design space from a given snapshot, selectively or fully. 
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Constant definitions of the module status. You can change the module status from the Warehouse 
Builder client using the property page of a module. 

• wb_dev_status: The module is under development. 

• wb_qa_status: The module is in QA status. 

• wb_prod_status: The module is in production. 
Constant definitions of object types. 

• WB_PROJECT 

• WBORACLEMODULE 

• WBGATEWAYMODULE 

• WB_SAP_MODULE 

• WB_FLAT_FILE_MODULE 

• WBSHAREDMODULE 

• WB_REPOS_MODULE 

• WB_COLLECTION 

• WB_WAREHOUSE 

• WB_TABLE 

• WB_VIEW 

• WB_MATEPJALIZED_VIEW 

• WBSEQUENCE 

• WB_DIMENSION_TABLE 

• WBCUBETABLE 

• WBJFLATFILE 

• WBPACKAGE 

• WBTRANSFORMATION 

• WB_MAPPING 

• WB_MIV_MODULE 

• WB_CONNECTOR 
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• WBJLOCATION 

• WBRUNTIMEREPOSITORY 

• WB_BUSINESS_AREA 

• WBINTELLIGENCEMODULE 

• WB_PROCESS_FLOW 

• WB_PROCESS_FLOW_MODULE 

• WB_PROCESS_FLOW_PACKAGE 

• WBQUERYOBJECT 

• WBADVANCEDQUEUE 
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Implementing the PL/SQL Interface 

When you implement the PL/SQL interface, you decide whether an operation is accepted or rejected 
based on the arguments passed by the Warehouse Builder client. Warehouse Builder also provides a 
public view named all_iv_firstclass_objects in its repository. This view contains the following 
information about an object: 

• Object UOID and class type 

• Object name and business name 

• Created by and updated by 

• Creation and update timestamps 

Given the object UOID, you can reference the public view for the above information. You can use this 
information from the public view to decide whether the operation is acceptable or not. 

The arguments passed by the caller provide you with different levels of security granularity: 

• Repository level: Check the repos_Schema argument as to whether to freeze the whole 
repository. 
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• Project level: Check the argument parentProjuoiD to freeze the whole project or not. 

• Installed module level: Check the argument parentModuieuoiD to freeze the whole installed 
module or not. 

• Object class type level: Check the argument objectTypeOperationinvokedOn to accept or 
prevent access to the entire type. 

• Object instance level: Check the object UOID. 

• Development process level: Check the argument: status (development, quality assurance, or 
production) to make access control decisions for an entire module. The status is an attribute of any 
module that you can change using the Warehouse Builder user interface through the module 
properties page. 

Considerations 

The following are considerations for implementing the PL/SQL interface: 

• If you base your access control decisions on the status of a module, Warehouse Builder 
recommends that only users in the administration group have the access to edit the module. 

• If a user has the validate/generate privilege on an object instance, such as a Table, and has no edit 
privilege on the object instance, the user can only validate/generate the object without the 
generated result persisting. 

• When you invoke an operation (operation A) from the Warehouse Builder client, in rare cases, 
operation B is invoked underneath. This can result in a situation where you have granted a user 
permission to invoke operation A, but the user can not successfully finish operation A because 
s/he has no permission to invoke operation B. 

To resolve this issue, you need to either grant the user privileges for both operations A and B, or 
not grant the user privileges on either operation. 

For example, in the mapping editor, when a bound object is added to a mapping, or when inbound 
reconcile is performed on an object, Warehouse Builder automatically creates a connector to the 
bound objects location if one does not already exist. To allow the user to finish adding a bound 
object into mapping editor, or to finish the inbound reconcile, you need to grant the user edit 
permission on the mapping and create permission for the connector. 

• To implement the PL/SQL procedures, you must not issue any commit or rollback command. 

Because the connection used to call the security PL/SQL procedures is the connection used to 
persist all the metadata, this connection is controlled by Warehouse Builder through its own 
transaction manager to determine when to commit or rollback. 

If you invoke commit or rollback in the procedure, it will corrupt the repository. If you want to 
record debug information in your PL/SQL procedure, you can do it in a separate child procedure, 
with autonomous transactions (use progma autonomousjxansaction at the beginning of the 
procedure). In this procedure, you can issue a commit or rollback command. 
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• If you grant a user the permission to create an object, the user also needs permission to edit the 
object. After an object is created, you can change your policy to revoke the user's edit permission 



on the object. 

• Do not perform any DML operations on the repository database objects created by Warehouse 
Builder when you implement the security PL/SQL procedures. This may damage the repository 
and make the Warehouse Builder client malfunction or stop functioning. 
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